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TO THE READER 



0.1 MANUAL OBJECTIVES AND READER ASSUMPTIONS 

This manual is intended to enable users to develop programs coded in 
the MACRO-11 V4.0 assembly language. 

No prior knowledge of the MACRO-11 Relocatable Assembler is assumed, 
but the reader should be familiar with the PDP-11 processors and 
related terminology, as presented in the PDP-11 Processor Handbooks. 
The reader is also encouraged to become familiar with the linking 
process, as presented in the applicable system manual (see Section 
0.3), because linking is necessary for the development of executable 
programs. 

If a terminal is available to the reader, he/she is advised to try 
some of the examples in the manual or to write a few simple programs 
that illustrate the concepts covered. Even experienced programmers 
find that working with a simple program helps them to understand a 
confusing feature of a new language. 

The examples in this manual were done on an RT-11 system. MACRO-11 
V4.0 may also be used on lAS/RSX-llM, RSX-llM-PLUS and RSTS systems 
(see Part IV for information about operating procedures) . 

It can be assumed that all references to RSX-llM also apply to 
RSX-llM-PLUS with the exception of those in Chapter 8, which deals 
with each system individually. 



0.2 STRUCTURE OF THE DOCUMENT 

This manual has four parts and eight appendices. 

Part I introduces MACRO-11. 

Chapter 1 lists the key features of MACRO-11. 

Chapter 2 identifies the advantages of following programming 
standards and conventions and describes the format used in coding 
MACRO-11 source programs. 

Part II presents general information essential to programming with the 
MACRO-11 assembly language. 

Chapter 3 lists the character set and describes the symbols, 
terms, and expressions that form the elements of MACRO-11 
instructions. 



Vlll 



chapter 4 describes the output of MACRO-11 and presents concepts 
essential to the proper relocation and linking of object modules. 

Chapter 5 describes how data stored in memory can be accessed and 
manipulated using the addressing modes recognized by the PDP-11 
hardware. 

Part III .describes the MACRO-11 directives that control the processing 
of source statements during assembly. 

Chapter 6 discusses directives used for generalized MACRO-11 
functions. 

/■"■ V» a T-\ ^ Q V ~ 

expansion of macros. 

Part IV presents the operating procedures essential to the assembly, 
linking, and initiating of MACRO-11 programs. 

Chapter 8 covers the IAS, RSX-llM and RSX-llM-PLUS systems. 

Chapter 9 covers the RSTS/RT-11 systems. 

Appendix A lists the ASCII and Radix-50 character sets used in 
MACRO-11 programs. 

Appendix B lists the special characters recognized by MACRO-11, 
summarizes the syntax of the various addressing modes used in PDP-11 
processors, and briefly describes the MACRO-11 directives in 
alphabetical order. 

Appendix C lists alphabetically the permanent symbols that have been 
defined for use with MACRO-11. 

Appendix D lists alphabetically the error codes produced by MACRO-11 
to identify various types of errors detected during the assembly 
process. 

Appendix E contains a coding standard that is recommended practice in 
preparing MACRO-11 programs. 

Appendix F discusses several methods of conserving dynamic memory 
space for users of small systems who may experience difficulty in 
assembling MACRO-11 programs. 

Appendix G is a discussion of position-independent code (PIC) . 

Appendix H contains an assembly and cross-reference listing. 



0.3 ASSOCIATED DOCUMENTS 

For descriptions of documents associated with this manual, refer to 
the applicable documentation directory listed below: 

IAS Documentation Directory 

RSX-llM-PLUS Documentation Directory 

RSX-llM/RSX-llS Documentation Directory 

RT-11 Documentation Directory 
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0.4 DOCUMENT CONVENTIONS 

The portions of text that are shaded in red pertain to features that 
are not available in the 8K version of MACRO-11. 

The portions of text that are shaded in gray pertain to features 
available only to users of the following operating systems (or 
subsequent versions) : 

RT-11 Version 4.0 

RSTS Version 7.0 

The color red is used in command string examples to indicate user 
type- in. 

The symbols defined below are used throughout this manual. 

Symbol Definition 

[] Brackets indicate that the enclosed argument is 

optional . 

... Ellipsis indicates optional continuation of an argument 

list in the form of the last specified argument. 

UPPER-CASE Upper-case characters indicate elements of the language 
CHARACTERS that must be used exactly as shown. 

lower-case Lower-case characters indicate elements of the language 
characters that are supplied by the programmer. 

(n) In some instances the symbol (n) is used following a 

number to indicate the radix. For example, 100(8) 
indicates that 100 is an octal value, while 100(10) 
indicates a decimal value. 



PART I 
MACRO-11: ASSEMBLY AND FORMATTING 



CHAPTER 1 
THE MACRO-11 ASSEMBLER 

MACRO-11 provides the following features: 

1. Source and command string control of assembly functions 

2. Device and filename specifications for input and output files 

3. Error listing on command output device 

4. Alphabetized, formatted symbol table listing; OptiQa'al' 
cross-reference listing of symbols 

5. Relocatable object modules 

6. Global symbols for linking object modules 

7. Conditional assembly directives 

8. Program sectioning directives 

9. User-defined macros and macro libraries 

10. Comprehensive system macro library 

11. Extensive source and command string control of listing 
functions. 

MACRO-11 assembles one or more ASCII source files containing MACRO-11 
statements into a single relocatable binary object file. The output 
of MACRO-11 consists of a binary object file and a file containing the 
table of contents, the assembly listing, and the symbol table. An 
optional cross-reference listing of symbols and macros is available. 
A sample assembly listing is provided in Appendix H. 

1.1 ASSEMBLY PASS 1 

During pass 1, MACRO-11 locates and reads all required macros from 
libraries, builds symbol tables and program section tables for the 
program, and performs a rudimentary assembly of each source statement. 

In the first step of assembly pass 1, MACRO-11 initializes all the 
impure data areas (areas containing both code and data) that will be 
used internally for the assembly process. These areas include all 

— J *--- _ -J _ „.- -^ « ^ ^ ^ ^ « 4. i_ Wt NJ UU^U l-l U J_ J. J. \^ Kj^^l.i^^<^ i. (^y J. ^il O • 
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THE MACRO-11 ASSEMBLER 

MACRO-11 then calls a system subroutine which transfers a command line 
into memory. This command line contains the specifications of all 
files to be used during assembly. After scanning the command line for 
proper syntax, MACRO-11 initializes the specified output files. These 
files are opened to determine if valid output file specifications have 
been passed in the command line. 

MACRO-11 now initiates a routine which retrieves source lines from the 
input file. If no input file is open, as is the case at the beginning 
of assembly, MACRO-11 opens the next input file specified in the 
command line and starts assembling the source statements. MACRO-11 
first determines the length of the instructions, then assembles them 
according to length as one word, two words, or three words. 

At the end of assembly pass 1, MACRO-11 reopens the output files 
described above. Such information as the object module name, the 
program version number, and the global symbol directory (GSD) for each 
program section are output to the object file to be used later in 
linking the object moduTes. After writing out the GSD for a given 
program section, MACRO-11 scans through the symbol tables to find all 
the global symbols that are bound to that particular program section. 
MACRO-11 then writes out GSD records to the object file for these 
symbols. This process is done for each program section. 



1.2 ASSEMBLY PASS 2 

On pass 2 MACRO-11 writes the object records to the output file while 
generating both the assembly listing and the symbol table listing for 
the program. iajryjr{|g^ft|gf pff|i^iqi^iii^^|g6|^giiia|Isp, .be g^necafeed. 

Basically, assembly pass 2 consists of the same steps performed in 
assembly pass 1, except that all source statements containing 
MACRO-11-detected errors are flagged with an error code as the 
assembly listing file is created. The object file that is created as 
the final consequence of pass 2 contains all the object records, 
together with relocation records that hold the information necessary 
for linking the object file. 

The information in the object file, when passed to the Task Builder or 
Linker, enables the global symbols in the object modules to be 
associated with absolute or virtual memory addresses, thereby forming 
an executable body of code. 

The user may wish to become familiar with the macro object file format 
and description. This information is presented in the applicable 
system manual (see Section 0.3 in the Preface). 
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CHAPTER 2 
SOURCE PROGRAM FORMAT 

2.1 PROGRAMMING STANDARDS AND CONVENTIONS 

Programming standards and conventions allow code written by a person 
(or group) to be easily understood by other people. These standards 
also make the program easier to: 

Plan 

Comprehend 

Test 

Modify 

Convert 

The actual standard used must meet local user requirements. A sample 
coding standard is provided in Appendix E. Used by DIGITAL and its 
users, this coding example simplifies both communications and the 
continuing task of software maintenance and improvement. 

2.2 STATEMENT FORMAT 

A source program is com.posed of assembly-language statements. Each 
statement must be completed on one line. Although a line may contain 
132 characters (a longer line causes an error (L) in the assembly 
listing) a line of 80 characters is recommended because of constraints 
imposed by listing format and terminal line size. Blank lines, 
although legal, have no significance in the source program. 

A MACRO-11 statement may have as many as four fields. These fields 

are identified by their order within the statement and/or by the 

separating characters between the fields. The general format of a 
MACRO-11 statement is: 

[Label:] Operator Operand [ ^Comment (s) ] 

The label and comment fields are optional. The operator and operand 
fields are interdependent; in other words, when both fields are 
present in a source statement, each field is evaluated by MACRO-11 in 
the context of the other. 

A statement may contain an operator and no operand, but the reverse is 
not true. A statement containing an operand with no operator is 
illegal and is interpreted by MACRO-11 during assembly as an implicit 
.WORD directive (see Section 6.3.2). 

MACRO-11 interprets and processes source program statements one by 
one. Each statement causes MACRO-11 either to perform a specified 
assembly process or to generate one or more binary instructions or 
data words. 
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2.2.1 Label Field 

A label is a user-defined symbol which is assigned the value of the 
current location counter and entered into the user-defined symbol 
table. The current location counter is used by MACRO-11 to assign 
memory addresses to the source program statements as they are 
encountered during the assembly process. Thus, a label is a means of 
symbolically referring to a specific statement. 

When a program section is absolute, the value of the current location 
counter is absolute; its value references an absolute virtual memory 
address (such as location 100) . Similarly, when a program section is 
relocatable, the value of the current location counter is relocatable; 
a relocation bias calculated at link time is added to the apparent 
value of the current location counter to establish its effective 
absolute virtual address at execution time. (For a discussion of 
program sections and their attributes, see Section 6.7.) 

If present, a label must be the first field in a source statement and 
must be terminated by a colon {:). For example, if the value of the 
current location counter is absolute 100(8), the statement: 



ABCD: 



MOV 



A,B 



assigns the value 100(8) to the label ABCD. If the location counter 
value were relocatable, the final value of ABCD would be 100(8)+K, 
where K represents the relocation bias of the program section, as 
calculated by the Task Builder or Linker at link time. 

More than one label may appear within a single label field. Each 
label so specified is assigned the same address value. For example, 
if the value of the current location counter is 100(8), the multiple 
labels in the following statement are each assigned the value 100(8): 



ABC: 



$DD: 



A7.7: 



MOV 



A,B 



Multiple labels may also appear on successive lines, 
statements 



For example, the 



ABC: 
$DD: 
A7.7i 



MOV 



A,B 



likewise cause the same value to be assigned to all three labels. 
This second method of assigning multiple labels is preferred because 
positioning the fields consistently within the source program makes 
the program easier to read (see Section 2.3). 



A double colon (::) defines 
example, the statement 



the label as a global symbol. For 



ABCD:: MOV 



A,B 



establishes the label ABCD as a global symbol. The distinguishing 
attribute of a global symbol is that it can be referenced from within 
an object module other than the module in which the symbol is defined 
(see Section 5.8) or by independently assembled object modules. 
References to this label in other modules are resolved when the 
modules are linked as a composite executable image. 
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The legal characters for defining labels are: 



A through Z 
through 9 
(Period) 
$ (Dollar Sign) 



NOTE 



By convention, the dollar sign ($) and 
period (.) are reserved for use in 
defining DIGITAL system software 
symbols. Therefore these characters 
should not be used in defining labels in 
MACRO-11 source programs. 

A label may be any length; however, only the first six characters are 
significant and, therefore, must be unique among all the labels in the 
source program. An error code (M) is generated in the assembly 
listing if the first six characters in two or more labels are the same 
(see Appendix D) . 

A symbol used as a label must not be redefined within the source 
program. If the symbol is redefined, a label with a multiple 
definition results, causing MACRO-11 to generate an error code (M) in 
the assembly listing (see Appendix D) . Furthermore, any statement in 
the source program which references a multi-defined label generates an 
error code (D) in the assembly listing (see Appendix D) . 



2.2.2 Operator Field 

The operator field specifies the action to be performed. It may 
consist of an instruction mnemonic (op code), an assembler directive, 
or a macro call. Chapters 6 and 7 describe these three types of 
operators. 

When the operator is an instruction mnemonic, a machine instruction is 
generated and MACRO-11 evaluates the addresses of the operands which 
follow. When the operator is a directive MACRO-11 performs certain 
control actions or processing operations during the assembly of the 
source program. When the operator is a macro call, MACRO-11 inserts 
the code generated by the macro expansion. 

Leading and trailing spaces or tabs in the operator field have no 
significance; such characters serve only to separate the operator 
field from the preceding and following fields. 

An operator is terminated by a space, tab, or any non-RAD50 

character* , 

as in the following examples: 

MOV A,B ;THE SPACE TERMINATES THE OPERATOR 

; MOV . 

MOV A,B ;THE TAB TERMINATES THE OPERATOR MOV. 

MOV@A,B ;THE @ CHARACTER TERMINATES THE 

; OPERATOR MOV. 

Although the statements above are all equivalent in function, the 
second statement is the recommended form because it conforms to 
MACRO-11 coding conventions. 



Appendix A. 2 contains a table of Radix-50 characters. 
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2.2.3 Operand Field 

When the operator is an instruction mnemonic (op code) , the operand 
field contains program variables that are to be evaluated/manipulated 
by the operator. The operand field may also supply arguments to 
MACRO-11 directives and macro calls, as described in Chapters 6 and 7, 
respectively. 

Operands may be expressions or symbols, depending on the operator. 
Multiple expressions used in the operand field of a MACRO-11 statement 
must be separated by a comma; multiple symbols similarly used may be 
delimited by any legal separator (a comma, tab, and/or space) . An 
operand should be preceded by an operator field; if it is not, the 
statement is treated by MACRO-11 as an implicit .WORD directive (see 
Section 6.3.2) . 

When the operator field contains an op code, associated operands are 
always expressions, as shown in the following statement: 

MOV R0,A+2(R1) 

On the other hand, when the operator field contains a MACRO-11 
directive or a macro call, associated operands are normally symbols, 
as shown in the following statement: 

.MACRO ALPHA SYMl,SYM2 

Refer to the description of each MACRO-11 directive (Chapter 7) to 
determine the type and number of operands required in issuing the 
directive. 

The operand field is terminated by a semicolon when the field is 
followed by a comment. For example, in the following statement: 

LABEL: MOV A,B ; COMMENT FIELD 

the tab between MOV and A terminates the operator field and defines 
the beginning of the operand field; a comma separates the operands A 
and B; and a semicolon terminates the operand field and defines the 
beginning of the comment field. When no comment field follows, the 
operand field is terminated by the end of the source line. 



2.2.4 Comment Field 

The comment field normally begins in column 33 and extends through the 
end of the line. This field is optional and may contain any ASCII 
characters except null, RUBOUT, carriage-return, line-feed, 
vertical-tab or form-feed. All other characters appearing in the 
comment field, even special characters reserved for use in MACRO-11, 
are checked only for ASCII legality and then included in the assembly 
listing as they appear in the source text. 
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All comment fields must begin with a semicolon (;). when lengthy- 
comments extend beyond the end of the source line (column 80) , the 
comment may be resumed in a following line. Such a line must contain 
a leading semicolon, and it is suggested that the body of the comment 
be continued in the same columnar position in which the comment began. 
A comment line can also be included as an entirely separate line 
within the code body. 

Comments do not affect assembly processing or program execution. 
However, comments are necessary in source listings for later analysis, 
debugging, or documentation purposes. 



2.3 FORMAT CONTROL 

Horizontal formatting of the source program is controlled by the space 
and tab characters. These characters have no effect on the assembly 
process unless they are embedded within a symbol, number, or ASCII 
text string, or unless they are used as the operator field terminator. 
Thus, the space and tab characters can be used to provide an orderly 
and readable source program. 

digital's standard source line format is shown below: 

Label - begins in column 1 

Operator - begins in column 9 

Operands - begin in column 17 

Comments - begin in column 33. 

These formatting conventions are not mandatory; free-field coding is 
permissible. However, note the increased readability after formatting 
in the example below: 

REGTST:BIT#MASK, VALUE; COMPARES BITS IN OPERANDS. 

1 9 17 33 (columns) 

REGTST: BIT #MASK, VALUE ; COMPARES BITS IN OPERANDS. 

Page formatting and assembly listing considerations are discussed in 
Chapter 6 in the context of MACRO-11 directives that may be specified 
to accomplish desired formatting operations. Appendix E contains a 
sample coding standard. 



2-5 



PART II 

PROGRAMMING 
IN MACRO-11 ASSEMBLY 
LANGUAGE 



CHAPTER 3 
SYMBOLS AND EXPRESSIONS 



This chapter describes the components of MACRO-11 instructions: the 
character set, the conventions observed in constructing symbols, and 
the use of numbers, operators, terms and expressions. 



3.1 CHARACTER SET 

The following characters are legal in MACRO-11 source programs: 

1. The letters A through 2. Both upper- and lower-case letters 
are acceptable, although, upon input, lower-case letters are 
converted to upper-case (see Section 6.2, .ENABL LC) . 

2. The digits through 9. 

3. The characters . (period) and $ (dollar sign). These 
characters are reserved for use as Digital Equipment 
Corporation system program symbols. 

4. The special characters listed in Table 3-1. 



Table 3-1 
Special Characters Used in MACRO-11 



Character 


Designation 


Function 


, 


Colon 


Label terminator. 


• ■ 


Double colon 


Label terminator; defines the 
label as a global label. 


= 


Equal sign 


Direct assignment operator and 
macro keyword indicator. 


— — 


Double equal 
sign 


Direct assignment operator; 
defines the symbol as a global 
symbol. 


"* • 


Equal sign colon* 


Direct assignment operator; 
macro keyword indicator; 
causes error (M) in listing if 
an attempt is made to change 
the value of the symbol. 



RT-11 V4.0 only. 
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Table 3-1 (Cont.) 
Special Characters Used in MACRO-11 



Character 


Designation 


Function 


■ 


Double equal 
sign colon* 


Direct assignment operator; 
defines the symbol as a global 
symbol; causes error (M) in 
listing if an attempt is made 
to change the value of the 
symbol . 


% 


Percent sign 


Register term indicator. 




Tab 


Item or field terminator. 




Space 


Item or field terminator. 


# 


Number sign 


Immediate expression 
indicator. 


@ 


At sign 


Deferred addressing indicator. 


( 


Left parenthesis 


Initial register indicator. 


) 


Right parenthesis 


Terminal register indicator. 


• 


Period 


Current location counter. 


r 


Comma 


Operand field separator. 


7 


Semicolon 


Comment field indicator. 


< 


Left angle 
bracket 


Initial argument or expression 
indicator . 


> 


Right angle 
bracket 


Terminal argument or 
expression indicator. 


+ 


Plus sign 


Arithmetic addition operator 
or autoincrement indicator. 


— 


Minus sign 


Arithmetic subtraction 
operator or autodecrement 
indicator. 


* 


Asterisk 


Arithmetic multiplication 
operator. 


/ 


Slash 


Arithmetic division operator. 


& 


Ampersand 


Logical AND operator. 


1 


Exclamation point 


Logical inclusive OR operator. 


II 


Double quote 


Double ASCII character 
indicator. 



* RT-11 V4.0 only. 



(continued on next page) 



3-2 



SYMBOLS AND EXPRESSIONS 



Table 3-1 (Cent, 3 
Special Characters Used in MACRO-11 



Character 


Designation 


Function 


' 


Single quote 


Single ASCII character 
indicator; or concatenation 
indicator. 


" 


Up arrow or 


Universal unary operator or 




circumflex 


argument indicator. 


\ 


Backslash 


Macro call numeric argument 
indicator . 



3.1.1 Separating and Delimiting Characters 

Legal separating characters and legal argument delimiters are defined 
in Tables 3-2 and 3-3 respectively. 



Table 3-2 
Legal Separating Characters 



Character 


Definition 


Usage 


Space 


One or more spaces 


A space is a legal separator 




and/or tabs 


between instruction fields and 
between symbolic arguments 
within the operand field. 
Spaces within expressions are 
ignored (see Section 3.9). 




Comma 


A comma is a legal separator 
between symbolic arguments 
within the operand field. 
Multiple expressions used in 
the operand field must be 
separated by a comma. 

t 



3.1.2 Illegal Characters 

A character is illegal for one of two reasons: 

1. If a character is not an element of the recognized MACRO-11 
character set, it is replaced in the listing by a question 
mark, and an error code (I) is printed in the assembly 
listing (see Appendix D) . The exception to this is an 
embedded null which, when detected, terminates the scan of 
the current line. 

2. If a legal MACRO-11 character is used in a source statement 
with illegal or questionable syntax, an error code (Q) is 
printed in the assembly listing. 
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Table 3-3 
Legal Argument Delimiters 



Character 


Definition 


Usage 


<.. .> 


Paired angle 


Paired angle brackets may be 




brackets 


used anywhere in a program to 
enclose an expression for 
treatment as a single term. 
Paired angle brackets are also 
used to enclose a macro 
argument, particularly when 
that argument contains 
separating characters (see 
Section 7.3) , 


A • • • X 


Up-arrow (unary 


This construction is 




operator) con- 


equivalent in function to the 




struction, where 


paired angle brackets 




the up-arrow is 


described above and is 




followed by an 


generally used only where the 




argument that is 


argument itself contains angle 




bracketed by any 


brackets. 




paired printing 






characters (x) . 





3.1.3 Unary and Binary Operators 

Legal MACRO-11 unary operators are described in Table 3-4. Unary 

operators are used in connection with single terms (arguments or 

operands) to indicate an action to be performed on that term during 

assembly. Because a term preceded by a unary operator is considered 
to contain that operator, a term so specified can be used alone or as 
an element of an expression. 



Table 3-4 
Legal Unary Operators 



Unary 








Operator 


Explanation 


Example 


Effect 


+ 


Plus sign 


+A 


Produces the positive 
value of A. 




Minus sign 


-A 


Produces the negative 
(2's complement) 
value of A. 



(continued on next page) 
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Table 3-4 (Cont.) 
Legal Unary Operators 



Unary 
Operator 


■ 

Explanation 




Example 


Effect 


^ 


Up-arrow, universal 
unary operator. 
(This usage is 
described in 
detail in 
Section 6.4.) 


"C24 
^D127 


Produces the I's 
complement value of 
24(8). 

Interprets 127 as a 
decimal number. 






'Fi.O 


Interprets J.O as a 
1 -wora , 

floatinq-point 
number . 






"034 


Interprets 34 as an 
octal number. 






"BllOOOlll 


Interprets 11000111 
as a binary number. 






"rabc 


Evaluates ABC in 
Radix-50 form. j 

^1 



Unary operators can be used adjacent to each other or in constructions 
involving multiple terms, as shown below: 

-"DSO (Equivalent to -<''D50>) 
"€'012 (Equivalent to "C<"012>) 

Legal MACRO-11 binary operators are described in Table 3-5. In 
contrast to unary operators, binary operators specify actions to be 
performed on multiple items or terms within an expression. 



Table 3-5 
Legal Binary Operators 



Binary 
Operator 


Explanation 


Example 


+ 


Addition 


A+B 


- 


Subtraction 


A-B 


* 


Multiplication 


A*B (signed 16-bit 

product returned) 


/ 


Division 


A/B (signed 16-bit 

quotient returned) 


& 


Logical AND 


A&B 


1 


Logical inclusive OR 


A!B 
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All binary operators have equal priority. Terms enclosed by angle 
brackets are evaluated first, and remaining operations are performed 
from left to right, as shown in the examples below: 

.WORD 1+2*3 ; EQUALS 11(8). 

.WORD l+<2*3> ;EQUALS 7(8). 



3.2 MACRO-11 SYMBOLS 

MACRO-11 maintains a symbol table for each of the three symbol types 
that may be defined in a MACRO-11 source program: the Permanent 
Symbol Table (PST) , the User Symbol Table (UST) , and the Macro Symbol 
Table (MST) . The PST contains all the permanent symbols defined 
within (and thus automatically recognized by) MACRO-11 and is part of 
the MACRO-11 image. The UST (for user-defined symbols) and MST (for 
macro symbols) are constructed as the source program is assembled. 



3.2.1 Permanent Symbols 

Permanent symbols consist of the instruction mnemonics (see Appendix 
C) and MACRO-11 directives (see Chapters 6 and 7 and Appendix B) . 
These symbols are a permanent part of the MACRO-11 image and need not 
be defined before being used in the operator field of a MACRO-11 
source statement (see Section 2.2.2). 



3.2.2 User-Defined and Macro Symbols 

User-defined symbols are those symbols that are equated to a specific 
value through a direct assignment statement (see Section 3.3), appear 
as labels (see Section 2.2.1), or act as dummy arguments (see Section 
7.1.1). These symbols are added to the User Symbol Table as they are 
encountered during assembly. 

Macro symbols are those symbols used as macro names (see Section 7.1). 
They are added to the Macro Symbol Table as they are encountered 
during assembly. 

The following rules govern the creation of user-defined and macro 
symbols: 

1. Symbols can be composed of alphanumeric characters, dollar 
signs ($) , and periods (.) only (see Note below). 

2. The first character of a symbol must not be a number (except 
in the case of local symbols; see Section 3,5). 

3. The first six characters of a symbol must be unique. A 
symbol can be written with more than six legal characters, 
but the seventh and subsequent characters are checked only 
for ASCII legality and are not otherwise evaluated or 
recognized by MACRO-11. 

4. Spaces, tabs, and illegal characters must not be embedded 
within a syinhol . The legal macrO-IT character set is defined 
in Section 3.1. 
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NOTE 

The dollar sign ($) and period (.) 
characters are reserved for use in 
defining Digital Equipment Corporation 
system software symbols. For example, 
READ$ is a file-processing system macro. 
The user is cautioned not to employ 
these characters in constructing 
user-defined symbols or macro symbols in 
order to avoid possible conflicts with 
existing or future Digital Equipment 
Corporation system software symbols. 

The value of a symbol depends upon its use in the program. A symbol 
in the operator field may be any one of the three symbol types 
described above; permanent, user-defined, or macro. To determine the 
value of an operator-field symbol, MACRO-11 searches the symbol tables 
in the following order: 

1. Macro Symbol Table 

2. Permanent Sym.bol Table 

3. User-Defined Symbol Table 

This search order allows permanent symbols to be used as macro 
symbols. But the user must keep in mind the sequence in which the 
search for symbols is performed in order to avoid incorrect 
interpretation of the symbol's use. 

When a symbol appears in the operand field, the search order is: 

1. User-Defined Symbol Table 

2. Permanent Symbol Table 

Depending on their use in the source program, user-defined symbols 
have either a local (internal) attribute or a global (external) 
attribute. 

Normally, MACRO-11 treats all user-defined symbols as local, that is, 
their definition is limited to the module in which they appear. 
However, symbols can be explicitly declared to be global symbols 
through one of three methods: 

1. Use of the .GLOBL directive (see Section 6.8). 

2. Use of the double colon (::) in defining a label (see Section 
2.2.1) . 

3. Use of the double equal sign (==) or double equal colon sign 
(==:) in a direct assignment statement (see Section 3.3)*. 

All symbols within a module that remain undefined at the end of 
assembly are treated as default global references. 



RT-11 V4.0 only. 
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Global symbols provide linkages between independently-assembled object 
modules within the task image. A global symbol defined as a label, 
for example, may serve as an entry-point address to another section of 
code within the image. Such symbols are referenced from other source 
modules in order to transfer control throughout execution. These 
global symbols are resolved at link time, ensuring that the resulting 
image is a logically coherent and complete body of code. 



3.3 DIRECT ASSIGNMENT STATEMENTS 

The General Format for a direct assignment statement is: 

symbol=expression 

or 

symbol==expression 

where: expression - can have only one level of forward reference 

(see 5 . below) . 

- cannot contain an undefined global reference. 
The Colon Format* for a direct assignment statement is: 

symbol= : expression 

or 

symbol==: express ion 

where: expression - can have only one level of forward reference 

(see 5 . below) . 

- cannot contain an undefined global reference. 

All the direct assignment statements above allow the user to equate a 
symbol with a specific value. After the symbol has been defined it is 
entered into the User-Defined Symbol Table. If the general format is 
used (= or ==) the value of the symbol may be changed in subsequent 
direct assignment statements. If, however, the colon format is used 
(=: or ==:) any attempt to change the value of the symbol will 
generate an error (M) in the assembly listing. 

A direct assignment statement embodying either the double equal (==) 
sign or the double equal colon (==:) sign, as shov?n above, defines the 
symbol as global (see Section 6.8). 



RT-11 V4.0 onlv. 
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The following examples illustrate the coding of direct assignment 
statements. 



Example 1; 

A=10 

B==30 

A=15 

L=:5 

H== :A+2 

L=4 



; DIRECT ASSIGNMENT 

; GLOBAL ASSIGNMENT 

; LEGAL REASSIGNMENT 

; EQUAL COLON ASSIGNMENT* 

;DOUBLE EQUAL COLON ASSIGNMENT* 
;M BECOMES EQUAL TO 17 

; ILLEGAL REASSIGNMENT 
;M ERROR IS GENERATED 



Example 2; 



C: 
D=. 

E: 



MOV 



#1,ABLE 



;THE SYMBOL D IS EQUATED TO ., AND 

?THE LABELS C AND E ARE ASSIGNED A 

; VALUE THAT IS EQUAL TO THE LOCATION 

;0F THE MOV INSTRUCTION. 



The code in the second example above would not usually be used and is 

shown only to illustrate the performance of MACRO-11 in such 

situations. See Section 3.6 for a description of the period (.) as 
the current location counter symbol. 

The following conventions apply to the coding of direct assignment 
statements: 

1. An equal sign (=) , double equal sign (==) , equal colon sign* 
{=:) or double equal colon sign* (==:) must separate the 
symbol from the expression defining the symbol's value. 
Spaces preceding and/or following the direct assignment 
operators, although permissible, have no significance in the 
resulting value. 

2. The symbol being assigned in a direct assignment statement is 
placed in the label field. 

3. Only one symbol can be defined in a single direct assignment 
statement. 

4. A direct assignment statement may be followed only by a 
comment field. 

5. Only one level of forward referencing is allowed. The 
following example would cause an error code (U) in the 
assembly listing on the line containing the illegal forward 
reference: 



X=Y 
Y=z 
Z=l 



(Illegal forward reference) 
(Legal forward reference) 



RT-11 V4.0 only. 



3-9 



SYMBOLS AND EXPRESSIONS 

Although one level of forward referencing is allowed for local 
symbols, no forward referencing is allowed for global symbols. In 
other words, the expression being assigned to a global symbol can 
contain only previously defined symbols. A forward reference in a 
direct assignment statement defining a global symbol will cause an 
error code (A) to be generated in the assembly listing. 



3.4 REGISTER SYMBOLS 

The eight general registers of the PDP-11 processor are numbered 
through 7 and can be expressed in the source program in the following 
manner: 

%0 
%1 



%7 

where % indicates a reference to a register rather than a location. 
The digit specifying the register can be replaced by any legal, 
absolute term that can be evaluated during the first assembly pass. 

The register definitions listed below are the normal default values 
and remain valid for all register references within the source 
program. 

R0=%0 ; REGISTER DEFINITION. 

R1=%1 ; REGISTER 1 DEFINITION. 

R2=%2 ; REGISTER 2 DEFINITION. 

R3=%3 ; REGISTER 3 DEFINITION. 

R4=%4 ; REGISTER 4 DEFINITION. 

R5=%5 ; REGISTER 5 DEFINITION. 

SP=%6 ; STACK POINTER DEFINITION. 

PC=%7 ; PROGRAM COUNTER DEFINITION. 

Registers 6 and 7 are given special names because of their unique 
system functions. The symbolic default names assigned to the 
registers, as listed above, are the conventional names used in all 
DIGITAL-supplied PDP-11 system programs. For this reason, you are 
advised to follow these conventions. 

A register symbol may be defined in a direct assignment statement 
appearing in the program. The defining expression of a register 
symbol must be a legal, absolute value between and 7, inclusive, or 
an error code (R) will appear in the assembly listing. Although you 
can reassign the standard register symbols through the use of the 
.DSABL REG directive (see Section 6.2), this practice is not 
recommended. An attempt to redefine a default register symbol without 
first specifying the .DSABL REG directive to override the normal 
register definitions causes that assignment statement to be flagged 
with an error code (R) in the assembly listing. All non-standard 
register symbols must be defined before they are referenced in the 
source program. 
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The % character may be used with any legal term or expression to 
specify a register. For example, the statement 

CLR %3+l 
is equivalent in function to the statement 

CLR %4 
and clears the contents of register 4. 
In contrast, the statement 

CLR 4 
clears the contents of virtual memory location 4. 

3.5 LOCAL SYMBOLS 

Local symbols are specially formatted symbols used as labels within a 
block of coding that has been delimited as a local symbol block. 
Local symbols are of the form n$ , where n is a decimal integer from 1 
to 65535, inclusive. Examples of local symbols are: 

1$ 

27$ 

59$ 

104$ 

A local symbol block is delimited in one of three ways: 

1. The range of a local symbol block usually consists of those 
statements between two normally-constructed symbolic labels 
(see Figure 3-1). Note that a. statement of the form: 

ALPHA=expression 

is a direct assignment statement (see Section 3.3) but does 

local symbol block. 

2. The range of a local symbol block is normally terminated upon 
encountering a .PSECT, .CSECT, .ASECT, or .RESTORE directive 
in the source program {see Figure 3-1) . 

3. The range of a local symbol block is delimited through 
MACRO-11 directives, as follows: 

Starting delimiter: .ENABL LSB (see Section 5.2) 

Ending delimiter: .ENABL LSB 

or 

one of the following: 

Symbolic label (see Section 2.2.1) 
•PSECT (see Section 6.7.1) 
.CSECT (see Section 6.7.2) 
.ASECT (see Section 6.7.2) 
;RHSTORB (see Section- 6 . 7 .4) 

encountered after a .DSABL LSB (see 
Section 6.2). 
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When defining local symbols, use the range from 1$ to 63$ first, then 
the range from 128$ to 65535$. Local symbols within the range 64$ 
through 127$, inclusive, can be generated automatically as a feature 
of MACRO-11. Such local symbols are useful in the expansion of macros 
during assembly (see Section 7.3.5). 

Be sure to avoid multiple definitions of local symbols within the same 
local symbol block. For example, if the local symbol 10$ is defined 
two or more times within the same local symbol block, each symbol 
represents a different address value. Such a multi-defined symbol 
causes an error code (P) to be generated in the assembly listing. 



For examples of local symbols and local symbol blocks as 
in a source program, see Figure 3-1. 



they appear 
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5 
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000000 


0.12700 
OOOOOOG 


xctprg; 


HOV 


tlHPURE.RO 


7 


000004 


005020 


It: 


CLR 


(R0) + 


8 


000006 


020027 
OOOOOOG 




CMP 


ROi*I«PURT 


9 


000012 


001374 




BNE 


1$ 


10 












11 












12 


000014 


012700 
OOOOOOG 


XCTPAS: 


MOV 


flMPPASfRO 


13 


000020 


005020 


1*: 


CLR 


<R0) + 


14 


000022 


020027 
OOOOOOG 




CMP 


ROf*IMPPflT 


15 


000026 


001374 




BNE 


1$ 


16 


000030 


000207 




RTS 


PC 



iPoint to inpore area 

)Cle3r 3 word 

JTest if 3t top of ares 

flterste if not 

iFall in to perfora pass initislizstion 

tPoint to pass storsse area 

fClear the area 

fTest if 3t top of area 

(Iterate of not 
(Return if so 



Figure 3-1 Assembly Listing Showing Local Symbol Block 



3.6 CURRENT LOCATION COUNTER 



The period (.) is the symbol for the current location counter. When 
used in the operand field of an instruction, the period represents the 
address of the first word of the instruction, as shown in the first 
example below. When used in the operand field of a MACRO-11 
directive, it represents the address of the current byte or word, as 
shown in the second example below. 
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A: MOV #.,R0 ;THE PERIOD (.) REFERS TO THE ADDRESS 

:0F THE MOV INSTRUCTION. 

(The function of the # symbol is explained in Section 5.9.) 

SAL=0 

.WORD 177 535,. +4, SAL ;THE OPERAND .+4 IN THE .WORD 

; DIRECTIVE REPRESENTS A VALUE 
;THAT IS STORED AS THE SECOND 
;0F THREE WORDS DURING 
; ASSEMBLY. 



assembly, MACRO-11 reserves storage in response to the .WORD directive 
(see Section 6.3.2), beginning with location 500. The operands 
accompanying the .WORD directive determine the values so stored. The 
value 177535 is thus stored in location 500. The value represented by 
.+4 is stored in location 502; this value is derived as the current 
value of the location counter (which is now 502) , plus the absolute 
value 4, thereby depositing the value 506 in location 502. Finally, 
the value of SAL, previously equated to , is deposited in location 
504. 

Figure 3-2 illustrates the result of the example. 



LOCATION 


CONTENTS 


500 


177535 


502 


506 


504 





Figure 3-2 Sample 


Assembly ; 



At the beginning of each assembly pass, MACRO-11 resets the location 
counter. Normally, consecutive memory locations are assigned to each 
byte of object data generated. However, the value of the location 
counter can be changed through a direct assignment statement of the 
following form: 

.=expression 

The current location counter symbol (.) is either absolute or 
relocatable, depending on the attribute of the current program 
section. 

The attribute of the current location counter can be changed only 
through the program sectioning directives (.PSECT, .ASECT, .CSECT and 
.■R^!K]©^ , as described in Section 6.7. Therefore, assigning to the 
counter an expression having an attribute different than that of the 
current program section will generates an error code (A) in the 
assembly listing. 

Furthermore, an expression assigned to the counter may not contain a 
forward reference ^a reference to a s^^mbol that is not previously 
defined) . The user must also be sure that the expression assigned 
will not force the counter into another program section, even if both 
sections involved have the same relocatability. Either of these 
conditions generates an error code (A) in the assembly listing. 



3-13 



SYMBOLS AND EXPRESSIONS 



The following coding illustrates the use 
counter; 



of the current location 



.ASECT 
.=500 

FIRST: MOV .+10, COUNT 



.=520 



SECOND: MOV 



, INDEX 



.PSECT 



.=.+20 



THIRD: .WORD 



SET LOCATION COUNTER TO 

ABSOLUTE 500 (OCTAL) . 

THE LABEL "FIRST" HAS THE VALUE 

500 (OCTAL) . 

.+10 EQUALS 510 (OCTAL). THE 

CONTENTS OF THE LOCATION 

510 (OCTAL) WILL BE DEPOSITED 

IN THE LOCATION "COUNT." 

THE ASSEMBLY LOCATION COUNTER 

NOW HAS A VALUE OF 

ABSOLUTE 520 (OCTAL) . 

THE LABEL SECOND HAS THE 

VALUE 520 (OCTAL) ,. 

THE CONTENTS OF LOCATION 

520 (OCTAL), THAT IS, THE BINARY 

CODE FOR THE INSTRUCTION 

ITSELF, WILL BE DEPOSITED IN THE 

LOCATION "INDEX." 

;SET LOCATION COUNTER TO 
? RELOCATABLE 20 OF THE 
;UNNAMED PROGRAM SECTION. 
;THE LABEL THIRD HAS THE 
; VALUE OF RELOCATABLE 20. 



Storage areas may be reserved in the program by advancing the location 
counter. For example, if the current value of the location counter is 
1000, each of the following statements: 



.=.+40 



or 

.BLKB 40 
or 
.BLKW 20 



reserves 40(8) bytes of storage space in the source program. The 
.BLKB and .BLKW directives, however, are the preferred ways to reserve 
storage space (see Section 6.5.3). 



3 . 7 NUMBERS 



MACRO-11 assumes that all numbers in the source program are to be 
interpreted in octal radix, unless otherwise specified. An exception 
to this assumption is that operands associated with Floating Point 
Processor instructions and Floating Point Data directives are treated 
as decimal (see Section 5.4.2). This default radix can be altered 
with the .RADIX directive (see Section 6.4.1.1). Also, individual 
numbers can be designated as decimal, binary, or octal numbers through 
temporary radix control operators (see Section 6.4.1.2). 

For every statement in the source program that contains a digit that 
is not in the current radix, an error code (N) is generated in the 
assembly listing. However, MACRO-11 continues with the scan of the 
statement and evaluates each such number encountered as a decimal 
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Negative numbers must be preceded by a minus sign; MACRO-11 
translates such numbers into two's complement form. Positive numbers 
may (but need not) be preceded by a plus sign. 

A number containing more than 16 significant bits (greater than 
177777(8)), is truncated from the left and flagged with an error code 
(T) in the assembly listing. 

Numbers are always considered to be absolute values; therefore, they 
are never relocatable. 

Single-word floating-point ' numbers may be generated with the "f 

r^v^o>y ri-«-^M- fiCOO ^i>f^-t- i/N*^ £^ A ^5 yi ^«rt ^y^i <i-*- f^y o^ irt ■*- Wis ■P*««.'i 1 *^i»T-i r^*^ -^ >-».»■¥»?>■«- « 

15., 14 ' ;' . 6 ' '0 ■ ■ : ' • :, 

Sign 8-bit 7-bit 
Bit Exponent - Mantissa 

Refer to the appropriate PDP-ll Processor Handbook for details of the 
floating-point number format. 



3 . 8 TERMS 

A term is a component of an expression and may be one of the 
following: 

1. A number, as defined in Section 3.7, whose 16-bit value is 
used. 

2. A symbol, as defined in Section 3.2. Symbols are evaluated 
as follows: 

a. A period (.) specified in an expression causes the value 
of the current location counter to be used. 

b. A defined symbol is located in the User-Defined Symbol 
Table (UST) and its value is used. 

c. A permanent symbol's basic value is used, with zero 
substituted for the addressing modes. (Appendix C lists 
all op codes and their values.) 

d. An undefined symbol is assigned a value of zero and 
inserted in the User-Defined Symbol Table as an undefined 
default global reference. If the .DSABL GBL directive 
(see Section 6.2) is in effect, the automatic global 
reference default function of MACRO-11 is inhibited, and 
the statement containing the undefined symbol is flagged 
with an error code (U) in the assembly listing. 

3. A single quote followed by a single ASCII character, or a 
double quote followed by two ASCII characters. This type of 
expression construction is explained in detail in Section 
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4. An expression enclosed in angle brackets (<>) . Any 
expression so enclosed is evaluated and reduced to a single 
term before the remainder of the expression in which it 
appears is evaluated. Angle brackets, for example, may be 
used to alter the left-to-right evaluation of expressions (as 
in A*B+C versus A*<B+C>) , or to apply a unary operator to an 
entire expression (as in -<A+B>) . 

5. A unary operator followed by a symbol or number. 



3.9 EXPRESSIONS 

Expressions are combinations of terms joined together by binary 
operators (see Table 3-5) . Expressions reduce to a 16-bit value. The 
evaluation of an expression includes the determination of its 
attributes. A resultant expression value may be any one of four types 
(as described later in this section): relocatable, absolute, 
external, or complex relocatable. 

Expressions are evaluated from left to right with no operator 
hierarchy rules, except that unary operators take precedence over 
binary operators. A term preceded by a unary operator is considered 
to contain that operator. (Terms are evaluated, where necessary, 
before their use in expressions.) Multiple unary operators are valid 
and are treated as follows: 

-+-A 

is equivalent to: 

-<+<-A>> 

A missing term, expression, or external symbol is interpreted as a 
zero. A missing or illegal operator terminates the expression 
analysis, causing error codes (A) and/or (Q) , to be generated in the 
assembly listing, depending on the context of the expression itself. 
For example, the expression: 

A + B 177777 

is evaluated as 

A + B 

because the first non-blank character following the symbol B is not a 
legal binary operator, an expression separator (a comma), or an 
operand field terminator (a semicolon or the end of the source line) . 
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NOTE 

Spaces within expressions can serve as 
delimiters only between symbols. In 
other words, the expressions 

A + B 

and 

A+B 

aro T-no c^aTna Kni- i-rt^ QT7Tnrvo'i C 

W«.I-'S«< \r X*^ Krf &«illli^ f tJ \^ ^ \.t.A\^ ^ y '"'■>-' ^-^ -^ O 

B17 
and 
B 17 
are not (B 17 is not a single symbol) . 

At assembly time the value of an external (global) expression is equal 
to the value of the absolute part of that expression. For example, 
the expression EXTERN+A, where "EXTERN" is an external symbol, has a 
value at assembly time that is equal to the value of the internal 
(local) symbol A. This expression, however, when evaluated at link 
time takes on the resolved value of the symbol EXTERN, plus the value 
of symbol A. 

Expressions, when evaluated by MACRO-11, are one of four types: 
relocatable, absolute, external, or complex relocatable. The 
following distinctions are important: 

1. An expression is relocatable if its value is fixed relative 
to the base address of the program section in which it 
appears; it will have an offset value added at link time. 
Terms that contain labels defined in relocatable program 
sections will have a relocatable value; similarly, a period 
(.) in a relocatable program section, representing the value 
of the current location counter, will also have a relocatable 
value. 

2. An expression is absolute if its value is fixed. An 
expression whose terms are numbers and ASCII conversion 
characters will reduce to an absolute value. A relocatable 
expression or term minus a relocatable term, where both 
elements being evaluated belong to the same program section, 
is an absolute expression. This is because every term in a 
program section has the same relocation bias. When one term 
is subtracted from another, the resulting bias is zero. 
MACRO-11 can then treat the expression as absolute and reduce 
it to a single terra upon completion of the expression scan. 
Terms that contain labels defined in an absolute section will 
also have an absolute value. 

3. An expression is external (or global) if it contains a single 
global reference (plus or minus an absolute expression value) 
that is not defined within the current program. Thus, an 
external expression is only partially defined following 
assembly and must be resolved at link time. 
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4. An expression is complex relocatable if any one of the 
following conditions applies: 

- It contains a global reference and a relocatable symbol. 

- It contains more than one global reference. 

- It contains relocatable terms belonging to different 
program sections. 

- The value resulting from the expression has more than one 
level of relocation. For example, if the relocatable 
symbols TAGl and TAG2 , associated with the same program 
section, are specified in the expression TAG1+TAG2 , two 
levels of relocation will be introduced, since each symbol 
is evaluated in terms of the relocation bias in effect for 
the program section. 

- An operation other than addition is specified on an 
undefined global symbol. 

- An operation other than addition, subtraction, negation, or 
complementation is specified for a relocatable value. 

The evaluation of relocatable, external, and complex relocatable 
expressions is completed at link time. 
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RELOCATION AND LINKING 



The output of MACRO-11 is an object module that must be processed or 
linked before it can be loaded and executed. Essentially, linking 
fixes (makes absolute) the values of relocatable or external symbols 
in the object module, thus transforming the object module, or several 
object modules, into an executable image. 

To allow the value of an expression to be fixed at link time, MACRO-11 
outputs certain instructions in the object file, together with other 
required parameters. For relocatable expressions in the object 
module, the base of the associated relocatable program section is 
added to the value of the relocatable expression provided by MACRO-11. 
For external expression values, the value of the external term in the 
expression (since the external symbol must be defined in one of the 
other object modules being linked together) is determined and then 
added to the absolute portion of the external expression, as provided 
by MACRO-11. 

All instructions that require modification at link time are flagged in 
the assembly listing, as illustrated in the example below. The 
apostrophe (') following the octal expansion of the instruction 
indicates that simple relocation is required; the letter G indicates 
that the value of an external symbol must be added to the absolute 
portion of an expression; and the letter C indicates that complex 
relocation analysis at link time is required in order to fix the value 
of the expression. 

EXAMPLE : 

005065 CLR REL0C(R5)" ; ASSUMING THAT THE VALUE OF THE 
000040' ; SYMBOL "RELOC", 40, IS RELOCATABLE 

;THE RELOCATION BIAS 
;WILL BE ADDED TO THIS VALUE. 

005065 CLR EXTERN (R5) ;THE VALUE OF THE SYMBOL "EXTERN" IS 
OOOOuOG ;ASSEMBLED AS ZERO AND IS 

; RESOLVED AT LINK TIME. 

005065 CLR EXTERN+6(R5) ;THE VALUE OF THE SYMBOL "EXTERN" 
000006G ;IS RESOLVED AT LINK TIME 

;AND ADDED TO 

;THE ABSOLUTE PORTION (+6) OF 
;THE EXPRESSION. 

OOOOOOC ; RELOCATABLE BECAUSE IT REQUIRES 

[THE NEGATION OF AN EXPRESSION 
;THAT CONTAINS A GLOBAL "EXTERN" 
[REFERENCE AND A RELOCATABLE TERM. 

For a complete description of object records output by MACRO-11, refer 
to the applicable system manual (see Section 0.3 in the Preface). 
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CHAPTER 5 
ADDRESSING MODES 



To understand how the address modes operate and how they assemble, the 
action of the program counter must be understood. The key rule to 
remember is: 

"whenever the processor implicitly uses the program counter 
(PC) to fetch a word from memory, the program counter is 
automatically incremented by 2 after the fetch operation is 
completed. " 

The PC always contains the address of the next word to be fetched. 
This word will be either the address of the next instruction to be 
executed, or the second or third word of the current instruction. 

Table 5-1 lists the address modes, and Table 5-2 lists the symbols 

used in this chapter to describe the address modes. Each mode of 

address in the chapter is illustrated using either the single operand 
instruction CLR or the double operand instruction MOV. 



Table 5-1 
Addressing Modes 







Section 


Mode 


Form 


Reference 


Register mode* 


R 


5.1 


Register deferred mode* 


OR or (ER) 


5.2 


Autoincrement mode* 


{ER) + 


5.3 


Autoincrement deferred mode* 


ia(ER) + 


5.4 


Autodecrement mode* 


-(ER) 


5.5 


Autodecrement deferred mode* 


@-(ER) 


5.6 


Index mode** 


E(ER) 


5.7 


Index deferred mode** 


§E(ER) 


5.8 


Immediate mode** 


#E 


5.9 


Absolute mode** 


@#E 


5.10 


Relative mode** 


E 


5.11 


Relative deferred mode** 


@E 


5.12 


Branch 


Address 


5.13 



uoes not increase tne lengtn or an instruction. 



** Adds one word to the instruction length for each occurrence of an 
operand of this form. 
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Symbol 



E 
R 



ER 



Table 5-2 
Symbols Used in Chapter 5 



Explanation 



Any expression, as defined in Chapter 3. 

A register expression; in other words, any 

expression containing a term preceded by a percent 

sign (%) or a symbol previously equated to such a 
term, as shown below: 

R0=%0 ; GENERAL REGISTER 0. 
Rl=RO+l jGENERAL REGISTER 1. 
R2=l+%1 ;GENERAL REGISTER 2. 

This symbol may also represent any of the normal 
default register definitions (see Section 3.4). 

A register expression or an absolute expression in 
the range to 7 , inclusive. 



5.1 REGISTER MODE 
Format: 
R 

The register itself (R) contains the operand to be manipulated by the 
instruction. 



Example: 

CLR R3 



; CLEARS REGISTER 3. 



5.2 REGISTER DEFERRED MODE 

Format: 

§R or (ER) 

The register (R) contains the address of the operand to be manipulated 
by the instruction. 



Examples; 



CLR @R1 
CLR (Rl] 
CLR M) 



;ALL THESE INSTRUCTIONS CLEAR 
;THE WORD AT THE ADDRESS 
; CONTAINED IN REGISTER 1, 
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5.3 AUTOINCREMENT MODE 



Format: 



(ER) + 

The contents of the register (ER) are incremented immediately- 
being used as the address of the operand (see Note below) . 



after 



Examples: 

CLR 
CLR 
CLR 



(R0) + 
( R4 ) + 
(R2) + 



;EACH INSTRUCTION CLEARS 
;THE WORD AT THE ADDRESS 
; CONTAINED IN THE SPECIFIED 
; REGISTER AND INCREMENTS 
;THAT REGISTER'S CONTENTS 
;BY TWO. 



NOTE 

Certain special instruction/address mode 
combinations, which are rarely or never 
used, do not operate the same on all 
PDP-11 processors, as described below. 

In the autoincrement mode, both the JMP 
and JSR instructions autoincrement the 
register before its use on the PDP-11/40 
but not on the PDP-11/45 or 11/10. 

In double operand instructions having 
the addressing form Rn,(Rn)+ or 
Rn,-(Rn), where the source and 
destination registers are the same, the 
source operand is evaluated as the 
autbincremented or autodecremented 
value, but the destination register, at 
the time it is used, still contains the 
originally intended effective address. 

^ lA ^-11^ j-\y ^ ^\rf' vv ^ 11^ \^^^G.iii^^s^ f ais c^ ^\ i^ v« lu u Ck.1 \jil 

the PDP-11/40, Register originally 
contains 100 (8) : 



MOV 



MOV 



RO, (R0)+ 



RO,-(RO) 



; THE QUANTITY 102 IS MOVED 
;T0 LOCATION 100. 

;THE QUANTITY 76 IS MOVED 
;T0 LOCATION 100. 



The use of these forms should be 
avoided, since they are not compatible 
with the entire family of PDP-11 
processors. 

An error code (z) is printed in the 
assembly listing with each instruction 
which is not compatible among all 
members of the PDP-11 family. 
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5.4 AUTOINCREMENT DEFERRED MODE 



Format: 



@(ER) + 

The register (ER) contains a pointer to the address of the operand. 
The contents of the register are incremented after being used as 
pointer . 



Example: 
CLR 



@(R3)+ 



;THE CONTENTS OF REGISTER 3 POINT 
;T0 THE ADDRESS OF A WORD TO BE 
; CLEARED BEFORE THE CONTENTS OF THE 
; REGISTER ARE INCREMENTED BY TWO. 



5. 5' AUTODECREMENT MODE 

Format: 

-(ER) 

The contents of the register (ER) are decremented before being used as 
the address of the operand (see Note in Section 5.3). 



Examples: 

CLR -(RO) 

CLR -(R3) 

CLR -(R2) 



; DECREMENT THE CONTENTS OF THE SPECI- 
;FIED REGISTER (0, 3, OR 2) BY TWO 
; BEFORE USING ITS CONTENTS 
;AS THE ADDRESS OF THE WORD TO BE 
; CLEARED . 



5.6 AUTODECREMENT DEFERRED MODE 

Format: 

@-(ER) 

The contents of the register (ER) are decremented before being used as 
a pointer to the address of the operand. 



Example: 
CLR 



@-(R2) 



DECREMENT THE CONTENTS OF 

REGISTER 2 BY TWO BEFORE 

USING ITS CONTENTS AS A POINTER 

TO THE ADDRESS OF THE WORD TO BE 

CLEARED. 
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5.7 INDEX MODE 



Format: 



E(ER) 

An expression (E) , plus the contents of a register (ER) , yields the 
effective address of the operand. In other words, the value E is the 
offset of the instruction, and the contents of register ER form the 
base. (The value of the expression (E) is stored as the second or 
third word of the instruction.) 



CLR 



MOV 



X+2(R1) 



R0,-2(R3) 



;THE EFFECTIVE ADDRESS OF THE WORD 

;T0 BE CLEARED IS X+2 , PLUS THE 

; CONTENTS OF REGISTER 1. 

;THE EFFECTIVE ADDRESS OF THE 

; DESTINATION LOCATION IS -2, PLUS 

;THE CONTENTS OF REGISTER 3. 



5.8 INDEX DEFERRED MODE 



Format: 



@E(ER) 

An expression (E) , plus the contents of a register (ER) , yields a 
pointer to the address of the operand. As in index mode above, the 
value E is the offset of the instruction, and the contents of register 
ER form the base. (The value of the expression (E) is stored as the 
second or third word of the instruction.) 



Example: 
CLR 



@114(R4) 



;IF REGISTER 4 CONTAINS 100, THIS 
; VALUE, PLUS THE OFFSET 114, YIELDS 
;THE POINTER 214. IF LOCATION 214 
;CONTAINS THE ADDRESS 2000, LOCATION 
;2000 WOULD BE CLEARED. 



NOTE 

The expression @(ER) may be used, but it 
will be assembled as if it were written 
@0(ER), and a word will be used to store 
the 0. 



5.9 IMMEDIATE MODE 

Format: 

#E 

Immediate mode allows the operand itself (E) to be stored as the 
second or third word of the instruction. The number sign (#) is an 
addressing mode indicator. Appearing in the operand field this 
character specifies the immediate addressing mode, indicating to 
MACRO-11 that the operand itself immediately follows the instruction 
word. This mode is assembled as an autoincrement of the PC. 
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Examples: 

MOV 
MOV 



#100, RO 
#X,RO 
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;MOVE THE VALUE 100 INTO REGISTER 0. 
;MOVE THE VALUE OF SYMBOL X INTO 
; REGISTER 0. 



The operation of this mode can be shown through the first example, 
MOV #100, RO, which assembles as two words: 

Location 20: 12 7 

Location 22: 10 

Location 24: Next instruction 

The source operand (the value 100) is assembled immediately following 
the instruction word. Upon execution of the instruction, the 
processor fetches the first word (MOV) and increments the PC by 2 so 
that it points to the second word, location 22, which contains the 
source operand. 

After the next fetch and increment cycle, the source operand (100) is 
moved into register 0, leaving the PC pointing to location 24 (the 
next instruction) . 



5.10 ABSOLUTE MODE 

Format: 

@#E 

Absolute mode is the equivalent of immediate mode deferred. The 
address expression @#E specifies an absolute address which is stored 
as the second or third word of the instruction. In other words, the 
value immediately following the instruction word is taken as the 
absolute address of the operand. Absolute mode is assembled as an 
autoincrement deferred of the PC. 



Examples: 
MOV 
CLR 



@#100,R0 
@#X 



;MOVE THE CONTENTS OF ABSOLUTE 
; LOCATION 100 INTO REGISTER RO . 
; CLEAR THE CONTENTS OF THE LOCATION 
jWHOSE ADDRESS IS SPECIFIED BY 
;THE SYMBOL X. 



the first example. 



The operation of this mode can be shown through 
MOV @#100,R0, which assembles as two words: 

Location 20: 13 7 

Location 22: 10 

Location 24: Next instruction 

The absolute address 100 is assembled immediately following the 
instruction word. Upon execution of the instruction, the processor 
fetches the first word (MOV) and increments the PC by 2 so that it 
points to the second word, location 22, which contains the absolute 
address of the source operand. After the next fetch and increment 
cycle, the contents of absolute address 100 (the source operand) are 
moved into register 0, leaving the PC pointing to location 24 (the 
next instruction) . 
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5.11 RELATIVE MODE 

Format: 

E 

Relative mode is the normal mode for memory references within your 
program. It is assembled as index mode, using the PC as the index 
register. The offset for the address calculation is assembled as the 
second or third word of the instruction. This value is added to the 
contents of the PC to yield the address of the source operand. 

Examples: 

CLR 100 ; CLEAR ABSOLUTE LOCATION 100 

MOV R0,Y ;MOVE THE CONTENTS OF REGISTER 

;T0 LOCATION Y 

The operation of relative mode can be shown with the statement 
MOV 100, R3, which assembles as two words: 

Location 20: 16 7 3 

Location 22: 5 4 

Location 24: Next instruction 

The offset, the constant 54, is assembled immediately following the 
instruction word. Upon execution of the instruction, the processor 
fetches the first word (MOV) and increments the PC by 2 so that it 
points to the second word, location 22, containing the value 54. 
After the next fetch and increment cycle, the processor calculates the 
effective address of the source operand by taking the contents of 
location 22 (the offset) and adding it to the current value of the PC, 
which now points to location 24 (the next instruction). Thus, the 
source operand address is the result of the calculation 
OFFSET+PC = 54+24 = 100(8), causing the contents of location 100 to be 
moved into register 3. 

The index mode statement: 

MOV 100-.-4(PC) ,R3 
is equivalent to the relative mode statement: 

MOV 100, R3. 

100-.-4 is the offset for the index mode statement. The current 
location counter (.) holds the address of the first word of the 
instruction (20, in this case) and the PC has to move down 4 bytes to 
reach location 24 (the next instruction). So, the offset could be 
written as 100-20-4 or 54(8). 

Therefore, for the index mode, the offset (54(8)) added to the 
PC (24 (8)) yields the effective address (54 + 24 = 100 (8)) of the 
operand. 

Thus, both statements move the contents of location 100 into register 
3. 
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NOTE 



The addressing form @#E differs from 
form E in that the second or third word 
of the instruction contains the absolute 
address of the operand, rather than the 
relative distance between the operand 
and the PC (see Section 5.10). Thus, 
the instruction CLR @#100 clears 
absolute location 100, even if the 
instruction is moved from the point at 
which it was assembled. See the 
description of the .ENABL AMA function 
in Section 6.2, which causes all 
relative mode addresses to be assembled 
as absolute mode addresses. 



5.12 RELATIVE DEFERRED MODE 
Format: 
@E 

The relative deferred mode is similar in operation to the relative 
mode above, except that the expression E is used as a pointer to the 
address of the operand. In other words, the operand following the 
instruction word is added to the contents of the PC to yield a pointer 
to the address of the operand. 

Example: 

MOV @X,RO ; RELATIVE TO THE CURRENT VALUE OF 

;THE PC, MOVE THE CONTENTS OF THE 
; LOCATION WHOSE ADDRESS IS POINTED 
;T0 BY LOCATION X INTO REGISTER 0. 



5.13 BRANCH INSTRUCTION ADDRESSING 

The branch instructions are 1-word instructions. The high-order byte 
contains the operator, and the low-order byte contains an 8-bit signed 
offset (seven bits, plus sign) , which specifies the branch address 
relative to the current value of the PC. The hardware calculates the 
branch address as follows: 

1. Extends the sign of the offset through bits 8-15. 

2. Multiplies the result by 2, creating a byte offset rather 
than a word offset. 

3. Adds the result to the current value of the PC to form the 
effective branch address. 

MACRO-11 performs the reverse operation to form the word offset from 
the specified address. 

Word offset = (E-PC)/2 truncated to eight bits. 

When the offset is added to the PC, the PC is moved to the next word 
(PC=.+2). Hence the -2 in the following calculation. 

word offset = (E-.-2)/2 truncated to eight bits. 
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The following conditions generate an error code (A) in the assembly- 
listing: 

1. Branching from one program section to another 

2. Branching to a location that is defined as an external 
(global) symbol 

3. Specifying a branch address that is out of range, meaning 
that the branch offset is a value that does not lie within 
the range -128(10) to +127(10). 



5.14 USING TRAP INSTRUCTIONS 

Since the EMT and TRAP instructions do not use the low-order byte of 
the instruction word, information is transferred to the trap handlers 
in the low-order byte. If the EMT or TRAP instruction is followed by 
an expression, the value of the expression is stored in the low-order 
byte of the word. Expressions greater than 377(8) are truncated to 
eight bits, and an error code (T) is generated in the assembly 
listing . 

For more information on traps see the PDP-11 Processor Handbook and 
the applicable system manual (see Section 0.3 in the Preface). 
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CHAPTER 6 
GENERAL ASSEMBLER DIRECTIVES 



A MACRO-11 directive is placed in the operator field of a source line. 
Only one directive is allowed per source line. Each directive may 
have a blank operand field or one or more operands. Legal operands 
differ with each directive. 



General assembler directives are 
categories: 



divided into the following 



x . uiSuing contrcx 

2. Function control 

3. Data storage 

4. Radix and numeric control 

5. Location counter control 

6. Terminators 

7. Program boundaries 

8. Program sectioning 

9. Symbol control 

10. Conditional assembly 

11. PAL-llR conditional assembly. 

Each is described in its own section of this chapter (see Table 6-1 

for an alphabetical listing of the directives and the associated 

section reference) . 



Table 6-1 
Directives in Chapter Six 



Directive 


Function 


Section 
Reference 


.ASCII 
.ASCIZ 


Stores delimited string as a sequence 
of the 8-bit ASCII code of their 
characters. 

Same as .ASCII except the string is 
followed by a zero byte. 


6.3.4 
6.3.5 



(continued on next page) 
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Table 6-1 (Cont.) 
Directives in Chapter Six 







Section 


Directive 


Function 


Reference 


.ASECT 


Similar to .PSECT. 


6.7.2 


.BLKB 


Allocates bytes of data storage. 


6.5.3 


.BLKW 


Allocates words of data storage. 


6.5.3 


.BYTE 


Stores successive bytes of data. 


6.3.1 


.CSECT 


Similar to .PSECT. 


6.7.2 


.DSABL 


Disables specified assembler 
functions. 


6.2 


.ENABL 


Enables specified assembler functions. 


6.2 


.END 


Indicates end of source input. 


6.6.1 


.ENDC 


Indicates end of conditional assembly 
block. 


6.9.1 


.EOT 


End of tape, ignored under RSX-llM, 
RSX-llM-PLUS, RT-11, RSTS and IAS 
systems. 


6.6.2 


.EVEN 


Ensures that current value of the 
location counter is even. 


6.5.1 


.FLT2 


Generates 2 words of storage for each 
floating-point number argument. 


6.4.2.1 


.PLT4 


Generates 4 words of storage for each 
floating-point number argument. 


6.4.2.1 


.GLOBL 


Defines listed symbols as global. 


6.8 


.IDENT 


Provides additional means of labeling 
an object module. 


6.1.5 


.IF 


Assembles block if specified condi- 
tions are met. 


6.9.1 


.IFF 


Assembles block if condition tests 
false. 


6.9.2 


.IFT 


Assembles block if condition tests 
true. 


6.9.2 


.IFTF 


Assembles block regardless of whether 
condition tests true or false. 


6.9.2 


• IIF 


Permits writing a one line conditional 
assembly block. 


6.9.3 



(continued on next page) 
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Table 6-1 (Cont.) 
Directives in Chapter Six 



Directive 



Function 



Section 
Reference 



.LIMIT 



• LIST 

.NLIST 

.ODD 

.PACKED 

.PAGE 
.PSECT 

.RAD50 

.RADIX 

. RESTORt: 

. SAVE 



.SBTTL 



.TITLE 



.WORD 



Allocates two words for storage. At 
link time puts the lowest address of 
the load image in one of the saved 
words and the address of the first 
free word following the image in the 
other . 

Increments listing count or lists 
certain types of code. 

Decrements listing count or suppresses 
certain types of code. 

Ensures that the current value of the 
location counter is odd. 

Generates packed decimal aata, two 
digits per byte. 

Starts a new listing page. 

Declares names for program sections 
and establishes their attributes. 

Generates data in Radix-50 packed 
format. 

Changes radices throughout or in 
portions of the source program. 

Retrieves a previously .SAVEd program 
section. 

Places the current program section on 
top of the program section context 
stack. 

Produces a table of contents 
immediately preceding the assembly 
listing and puts subheadings on each 
page in the listing. 

Assigns a name to the object module 
and puts headings on each page of 
the assembly listing. 

Generates successive words of data in 

the object module. 



6.5.4 



6.1.1 

6.1.1 

6.5.2 

b. 3.8 

6.1.6 
6.7.1 

6.3.6 



6.7.4 



6.7.3 



i.1.4 



6.1.3 



6.3.2 
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6.1 LISTING CONTROL DIRECTIVES 

Listing control directives control the content, format, and pagination 
of all line printer (see Figure 6-1) and teleprinter (see Figure 6-2) 
assembly listing output. On the first line of each page, MACRO-11 
prints the following (from left to right) : 

1. Title of the object module, as established through the .TITLE 
directive (see Section 6.1.2), 

2. Assembler version identification. 

3. Date, 

4. Time of day. 

5. Page number. 

The second line of each assembly listing page contains the subtitle 
text specified in the last-encountered .SBTTL directive (see Section 
6.1,3) . 

In the line printer format (Figure 6-1) binary extensions for 
statements generating more than one word are listed horizontally. 

In the teleprinter format (Figure 6-2) binary extensions for 
statements generating more than one word are listed vertically. There 
is no explicit truncation of output to 80 characters by the assembler. 
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■ LIST] 



6.1.1 



.LIST and .NLIST Directives 



.NLIST 



Formats: 



.LIST 
.LIST 
.NLIST 
.NLIST arg 



cii'y 



where: 



arg 



represents one or more of the 
arguments defined in Table 6-2. 



optional symbolic 



As indicated above, the listing control directives may be used without 
arguments, in which case the listing directives alter the listing 
level count. The listing level count is initialized to zero. At each 

of a .LIST directive, the listing level count is 
at each occurrence of an .NLIST directive, the listing 
is decremented. When the level count is negative, the 

suppressed (unless the line contains an error) . 

when the level count is greater than zero, the listing is 
generated regardless of the context of the line. Finally, when the 
count is zero, the line is either listed or suppressed, depending on 
the listing controls currently in effect for the program. The 
following macro definition employs the .LIST and .NLIST directives to 
selectively list portions of the macro body when the macro is 
expanded: 



occurrence 
incremented; 
level count 
listing is 
Conversely, 







. MACRO LTEST 


r 


A-THIS 


LINE SHOULD 
.NLIST 


LIST 


• 


B-THIS 


LINE SHOULD 
.NLIST 


NOT LIST 


• 


C-THIS 


LINE SHOULD 
.LIST 


NOT LIST 


7 


D-THIS 


LINE SHOULD 
.LIST 


NOT LIST 


/ 


E-THIS 


LINE. SHOULD 


LIST 


/ 


F-THIS 


LINE 'should 


LIST 


• ■ 
/ 


G-THIS 


LI-NE SHOULD 


LIST 



.ENDM 



;LIST TEST 

; LISTING LEVEL COUNT IS 0. 

; LISTING LEVEL COUNT IS -1 . 

; LISTING LEVEL COUNT IS -2. 

; LISTING LEVEL COUNT IS -1. 

; LISTING LEVEL COUNT IS 0. 

; LISTING LEVEL COUNT IS 0. 

; LISTING LEVEL COUNT IS 0. 

; LISTING LEVEL COUNT IS 0. 



.LIST ME 

LTEST 
A-THIS LINE SHOULD LIST 
E-THIS LINE SHOULD LIST 
F-THIS LINE SHOULD LIST 
G-THIS LINE SHOULD LIST 



;LIST MACRO EXPANSION. 
;CALL THE MACRO 

; LISTING LEVEL COUNT IS 0, 

; LISTING LEVEL COUNT IS 0. 

; LISTING LEVEL COUNT IS 0, 

; LISTING LEVEL COUNT IS 0, 



Note that the lines following line E will list because the 
level count remains Q "^f ^ ttct A^vc^r^i-^^ra -i <? ni , 



listing 

beginning of a program, all macro expansions will be listed unless a 
.NLIST directive is encountered. 



An important purpose of the level count is to allow macro expansions 
to be listed selectively and yet exit with the listing level count 
restored to the value existing prior to the macro call. 
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When used with arguments, the listing directives do not alter the 
listing level count. However, the .LIST and .NLIST directives can be 
used to override current listing control, as shown in the example 
below: 

. MACRO XX 



X=. 



.LIST 
•NLIST 



;LIST NEXT LINE. 

;D0 NOT LIST REMAINDER OF MACRO 
; EXPANSION. 



,ENDM 



.NLIST 
XX 



ME 



;D0 NOT LIST MACRO EXPANSIONS, 



The symbolic arguments allowed for use with the listing directives are 
described in Table 6-2. These arguments can be used singly or in 
combination with each other. If multiple arguments are specified in a 
listing directive, each argument must be separated by a comma, tab, or 
space. For any argument not specifically included in the control 
statement, the associated default assumption (List or No list) is 
applicable throughout the source program. The default assumptions for 
the listing control directives also appear in Table 6-2. 



Table 6-2 
Symbolic Arguments of Listing Control Directives 



Argument 


Default 


Function 


SEQ* 


List 


Controls the listing of the sequential 
numbers assigned to the source lines. 
If this number field is suppressed 
through an .NLIST SEQ directive, 
MACRO-11 generates a tab, effectively 
allocating blank space for the field. 
Thus, the positional relationships of 
the other fields in the listing remain 
undisturbed. During the assembly 
process, MACRO-11 examines each source 
line for possible error conditions. 
For any line in error, the error code 
is printed preceding the number field. 
MACRO-11 does not assign line numbers 
to files that have had such numbers 
assigned by other programs (an editor 
program, for instance) . 



(continued on next page) 



* If the .NLIST arguments SEQ, LOC , BIN, and SRC are in effect at 
the same time, that is, if all four significant fields in the 
listing are to be suppressed, the printing of the resulting blank 
line is inhibited. 
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Table 6-2 (Cont.) 
Symbolic Arguments of Listing Control Directives 



Argument 



Default 



Function 



LOC* 



List 



BIN'' 



List 



BEX 



List 



SRC* 
COM 



List 
List 



MD 



MC 



ME 



List 



List 



No list 



Controls the listing of the current 
location counter field. Normally, 
this field is not suppressed. 
However, if it is suppressed through 
the .NLIST LOC directive, MACRO-11 

J i. » ^ -. i- ,^ ^ J- -s u » A -^ ^AA^ •; 4- 

allocate space for the field, as is 
the case with the SEQ field described 
above. Thus, the suppression of the 
current location counter (LOC) field 
effectively left-justifies all 
subsequent fields (while preserving 
positional relationships) to the 
position normally occupied by the 
counter's field. 

Controls the listing of generated 
binary code. If this field is 
suppressed through an .NLIST BIN 
directive, left-justification of the 
source code field occurs in the same 
manner described above for the LOC 
field. 

Controls the listing of binary 
extensions (the locations and binary 
contents beyond those that will fit on 
the source statement line). This is a 
subset of the BIN argument. 

Controls the listing of source lines. 

Controls the listing of comments. 
This is a subset of the SRC argument. 
The .NLIST COM directive reduces 
listing time and space when comments 
are not desired. 

Controls the listing of macro 
definitions and repeat range 
expansions. 

Controls the listing of macro calls 
and repeat range expansions. 



Controls the listing 
expansions. 



of 



macro 



(continued on next page) 



* If the .NLIST arguments SEQ, LOC, BIN, and SRC are in effect at the 
same time, that is, if all four significant fields in the listing are 



to be suppressed, 
inhibited. 



the printing of the resulting blank line is 
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Table 6-2 (Cont.) 
Symbolic Arguments of Listing Control Directives 



Argument 



Default 



Function 



MEB 



NO list 



CND 



List 



LD 



TOC 



NO list 



List 



SYM 



TTM* 



List 



List 



Controls the listing 



of 



macro 



expansion binary code, A .LIST MEB 
directive lists only those macro 
expansion statements that generate 
binary code. This is a subset of the 
ME argument. 

Controls the listing of unsatisfied 
corfditional coding and associated .IF 
and .ENDC directives in the source 
program. A .NLIST CND directive lists 
only satisfied conditional coding. 

Controls the listing of all listing 
directives having no arguments, in 
other words, the directives that alter 
the listing level count. 

Controls the listing of the table of 
contents during assembly pass 1 (see 
Section 6.1.3 describing the .SBTTL 
directive) . This argument does not 
affect the printing of the full 
assembly listing during assembly pass 
2. 

Controls the listing of the symbol 
table resulting from the assembly of 
the source program. 

Controls the listing output format. 
The default can be set by the system 
manager. If the system manager does 
not set a default, it is set to line 
printer format. Figure 6-1 
illustrates the line printer output 
format. Figure 6-2 illustrates the 
teleprinter output format. 



The default for RSX-llM and RT-11 programs is no list. 



Any argument specified in a .LIST/. NLIST directive other than those 
listed in Table 6-2 causes the directive to be flagged with an error 
code (A) in the assembly listing. 

The listing control options can also be specified at assembly time 
through switches included in the command string to MACRO-il (see 
Section 8.1,3 and/or the appropriate system manual). The use of these 
switches overrides all corresponding listing control (.LIST or .NLIST) 
directives specified in the source program. 

Figure 6-3 shows a listing, produced in line printer format, 
reflecting the use of the .LIST and .NLIST directives in the source 
program and the effects such directives have on the assembly listing 
output. 
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6.1.2 .TITLE Directive 



.TITLE 



Format: 



.TITLE string 



where: string 



represents an identifier of 1 or more Radix-50 
characters. Appendix A. 2 contains a table of Radix-50 
characters. 



The .TITLE directive assigns a name to the object module. The name 
assigned is the first six non-blank, Radix-50 characters following the 
.TITLE directive. All spaces and/or tabs up to the first 
non-space/non-tab character following the .TITLE directive are ignored 
by MACRO-11 when evaluating the text string. Any characters beyond 
the first six are checked for ASCII legality, but they are not used as 
part of the object module name. For example, the directive: 

.TITLE PROGRAM TO PERFORM DAILY ACCOUNTING 

causes the assembled object module to be named PROGRA. This 
6-character name bears no relationship to the filename of the object 
module, as specified in the command string to MACRO-11. The name of 
an object module (specified in the .TITLE directive) appears in the 
load map produced at link time. This is also the module name which 
the Librarian will recognize. 

If the .TITLE directive is not specified, MACRO-11 assigns the default 
name .MAIN. to the object module. If more than one .TITLE directive 
is specified in the source program, the last .TITLE directive 
encountered during assembly pass 1 establishes the name for the entire 
object module. 

If the .TITLE directive is specified without an object module name, or 
if the first non-space/non-tab character in the object module name is 
not a Radix-50 character, the directive is flagged with an error code 
(A) in the assembly listing. 



6.1.3 .SBTTL Directive 
Format: 



•SBTTL 



, SBTTL string 



where: string 



represents 

characters. 

characters. 



an identifier of 1 or more Radix-50 
Appendix A. 2 contains a table of Radix-50 
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The .SBTTL directive is used to produce a table of contents 
immediately preceding the assembly listing and to print the text 
following the .SBTTL directive on the second line of the header of 
each page in the listing. The subheading in the text will be listed 
until altered by a subsequent .SBTTL directive in the program. For 
example, the directive: 

.SBTTL CONDITIONAL ASSEMBLIES 

causes the text 

CONDITIONAL ASSEMBLIES 

to be printed as the second line in the header of the assembly 
listing. 

During assembly pass 1, a table of contents containing the line 
sequence number, the page number, and the text accompanying each 
.SBTTL directive is printed for the assembly listing. The listing of 
the table of contents is suppressed whenever an .NLIST TOC directive 
is encountered in the source program (see Table 6-2) . An example of a 
table of contents listing is shown in Figure 6-4. 



MTTEMT - RT-11 MULTI-TTY EMT SE MACRO Y04.00 lO-OCT-79 15:00{26 
TABLE OF CONTENTS 



50- 1 


.HTOUT 


51- 1 


.MTRCTO 


52- 1 


.MTATCH 


54- 1 


.MTDTCH 


55- 1 


•MTPRNT 


Si- 1 


.MTSTAT 


57- 1 


MTTIN - 


58- 1 


MTTGET 


59- 1 


TTRSET 


60- 1 


MTTPUT 


62- 1 


MTRSET 


63- 1 


ESCAPE 


Figure 


6-4 R 



■ Single character output EMT 

- Reset CTRL/O EMT 

- Attach to terminal EHT 

- Detach fro* a teminal EMT 

- Print nesssse EMT 

- Return multi-terainal susten status EMT 
Sindle character input 

■ Get a character froa the rina buffer 

■ Reset terminal status bits 

■ Sinale character output 

- Stop and detach all terminals attached to 
ESCAPE SEQUENCE TEST SUBROUTINE 



Assembly Listing Table of Contents 



a Job 



NOTE 

When using the .SBTTL directive it is 
not a good idea to use the switch that 
assembles only pass 1. During assembly 
pass 1 the pages of the listing are 
numbered and a table of contents listed. 
After assembly pass 2, if the switch is 
used on one or more of the files, the 
table of contents will be incorrect 
because a complete re-numbering of the 
listing is not possible. 
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.IDENT 



6.1.4 .IDENT Directive 

Format: 

.IDENT /string/ 

where: string represents six or fewer Radix-50 characters which 
establish the program identification or version 
number. This number is included in the global symbol 
directory of the object module; the first four 
characters are printed in the load map and librarian 
listing. 

/ / represent delimiting characters. These delimiters may 
be any paired printing characters, other than the 
equal sign (=) , the left angle bracket (<) , or the 
semicolon (;),. as long as the delimiting character is 
not contained within the text string itself (see Note 
in Section 6.3.4). If the delimiting characters do 
not match, or if an illegal delimiting character is 
used, the .IDENT directive is flagged with an error 
code (A) in the assembly listing. 

In addition to the name assigned to the object module with the .TITLE 
directive (see Section 6.1.3), the .IDENT directive allows the user to 
label the object module with the program version number. 

An example of the .IDENT directive is shown below: 

.IDENT /V05A/ 

The character string V05A is converted to Radix-50 representation and 
included in the global symbol directory of the object module. This 
character string also appears in the load map produced at link time 
and the Librarian directory listings. 

When more than one .IDENT directive is encountered in a given program, 
the last such directive encountered establishes the character string 
which forms part of the object module identification. 

RT-11 allows only one .IDENT string in a program. The linker uses the 
first .IDENT directive encountered during the first pass to establish 
the character string that will be identified with all of the object 
modules. 

RSX-llM allows an .IDENT string for each module in the program. The 
Task Builder uses the first .IDENT directive in each module to 
establish the character string that will be identified with that 
module. Like the RT-11 Linker, the RSX-llM Task Builder uses the 
.IDENT directives encountered on the first pass. 
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.PAGE 



6.1,5 .PAGE Directive/Page Ejection 

Format: 

.PAGE 

The .PAGE directive is used within the source program to perform a 
page eject at desired points in the listing. This directive takes no 
arguments and causes a skip to the top of the next page when 
encountered, it also causes the page number to be incremented and the 
line sequence counter to be cleared. The .PAGE directive does not 
appear in the listing. 

When used within a macro definition, the .PAGE directive is ignored 
during the assembly of the macro definition. Rather, the page eject 
operation is performed as the macro itself is expanded. In this case, 
the page number is also incremented. 

Page ejection is accomplished in three other ways: 

1. After reaching a count of 58 lines in the listing, MACRO-11 
automatically performs a page eject to skip over page 
perforations on line printer paper and to formulate 
teleprinter output into pages. The page number is not 
changed. 

2. A page eject is performed when a form-feed character is 
encountered. If the form-feed character appears within a 
macro definition, a page eject occurs during the assembly of 
the macro definition, but not during the expansion of the 
macro itself. A page eject resulting from the use of the 
form-feed character causes the page number to be incremented 
and the line sequence counter to be cleared. 

3. A page eject is performed when encountering a new source 
file. In this case the page number is incremented and the 
line sequence count is reset. 



.ENABL 



6.2 FUNCTION DIRECTIVES: .ENABL AND .DSABL 



.DSABL 



Formats: 




.ENABL 
.DSABL 


arg 
arg 



where: arg represents one or more of the optional symbolic 
arguments defined in Table 6-3. 

These directives are included in a source program to invoke or inhibit 
certain MACRO-11 functions and operations incidental to the assembly 
process itself. Specifying any argument in an .ENABL/. DSABL directive 
other than those listed in Table 6-3 causes that directive to be 
flagged with an error code (A) in the assembly listing. 
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Table 6-3 
Symbolic Arguments of Function Control Directives 



Argument 



ABS 



AMA 



CDR 



Default 



Function 



Disable 



Disable 



Disable 



CRF 



FPT 



LSB 



Enable 



Disable 



Disable 



Disable 



Enabling this function produces absolute 
binary output in FILES-11 format. To 
convert this output to Formatted Binary 
format (as required by the Absolute 
Loader) , use the FLX utility. 

Dllciuxxiig uHj-S j_uin^uiwii wciuoco aj.-!. j. t:; j. w i_ j. v c 

addresses (address mode 67) to be assembled 
as absolute addresses (address mode 37) . 
This function is useful during the 
debugging phase of program development. 

Enabling this function causes source 
columns from 73 to the end of the line, to 
be treated as a comment. The most common 
use of this feature is to permit sequence 
numbers in card columns 73-80. 

Disabling this function inhibits the 
generation of cross-reference output. This 
fufnction only has meaning if 
cross-reference output generation is 
specified in the command string.. 

Enabling this function causes fiojatmg- 
point truncation? disabling th,is function 
causes floating-point rounding. 

Enabling this function causes MACRO-11 to 
accept lower-case ASCII input instead of 
converting it to upper-case. If this 
function is not enabled, all text is 
converted to upper-case. 

This argument permits the enabling or 
disabling of a local symbol block. 
Although a local symbol block is normally 
established by encountering a new symbolic 
label, a .PSECT directive or a ,RESTQRE 
directive in the source program, an .ENABL 
LSB directive establishes a new local 
symbol block which is not terminated until 

(1) another .ENABL LSB is encountered, or 

(2) another symbolic label, .PSECT 
directive or .RESTORE directive is 
encountered following a paired .DSABL LSB 
directive. 



The basic funct 
regard to 
instances where 
program sectio 
followed by a 
program sectio 
of the current 
accomplished th 
directives (see 



ion of this directive with 
PSECTs is limited to those 

it is desirable to leave a 
n temporarily to store data, 
return to the original 
n. This temporary dismissal 
program section may also be 
rough the .SAVE and .RESTORE 

Sections 6.7.3 and 6.7.4). 



(continued on next page) 
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Table 6-3 (Cont.) 
Symbolic Arguments of Function Control Directives 



Argument 



LSB (cont.) 



PNC 



REG 



Default 



Disable 



GBL^ 



Enable 



Enable 



Enable 



Function 



Attempts to define local symbols in an 
alternate program section are flagged with 
an error code (P) in the assembly listing. 

An example of the .ENABL LSB and .DSABL LSB 
directives, as typically used in a source 
program, is shown in Figure 6-5. 

Disabling this function inhibits binary 
output until an .ENABL PNC statement is 
encountered within the same module. 

When specified, the .DSABL REG directive 
inhibits the normal MACRO-11 default 
register definitions; if not disabled, the 
default definitions listed below remain in 
effect. 

R0=%0 
R1=%1 
R2=%2 
R3=%3 
R4=%4 
R5=%5 
SP=%6 
PC=%7 

The .ENABL REG Statement may be used as the 
logical complement of the .DSABL REG 
directive. The use of these directives, 
however, is not recommended. For logical 
consistency, use the normal default 
register definitions listed above. 

When the .ENABL GBL directive is specified, 
MACRO-11 treats all symbol references that 
are undefined at the end of assembly pass 1 
as default global references; when the 
.DSABL GBL directive is specified, MACRO-11 
treats all such references as undefined 
symbols. In assembly pass 2, if the .DSABL 
GBL function is still in effect, these 
undefined symbols are flagged with an error 
code (U) in the assembly listing; 
otherwise, they continue to be regarded by 
MACRO-11 as global references. 



The default is Disable for RT-11 MACRO programs, 
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.ENABL/.DSABL MACRO Y04.00 24-0CT-79 18!26!26 PAGE 1 



3 

A 

5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 

16 000000 
000000 
17 
18 
19 

20 000033 
000033 
21 



124 



124 



150 



151 



111 



.TITLE .ENABL/.DSAEL 

t + 

; ILLUSTRATE .ENABL/.DSABL LC 

? ~ 

.ENAEL LC (STORE MACRO IN LOWER CASE 



.MACRO 
.ENDM 



TEXT 
.ASCII 



.LIST 
•NLIST 



TEXT 
.ASCII 



$$» 

/This *t« a lower case 



ME 
BEX 



itrina/ 



is i Invoke nscro in lower esse 
/This is 3 lower esse strinS/ 



.CSABL LC 



(Now disable lower case 



OOOOOl 



TEXT 
.ASCII 



.END 



WAS ;RE-INV0KE macro IN UPPER CASE 
/THIS WAS A LOWER CASE STRING/ 



Figure 6-5 Example of .ENABL and .DSABL Directives 



6.3 DATA STORAGE DIRECTIVES 

A v;ide range of data and data types can be generated with the 
directives, ASCII conversion characters, and radix-control operators 
described in the following sections. 



6.3.1 



.BYTE Directive 



.BYTE 



.BYTE 



.BYTE 



exp 



; STORES THE BINARY VALUE OF THE 

; EXPRESSION "EXP" IN THE NEXT BYTE. 



where: exp, 

expl , 



expl,exp2,expn ;STORES THE BINARY VALUES OF THE LIST 
;0F EXPRESSIONS IN SUCCESSIVE BYTES. 

represent expressions that must be reduced to 8 bits 
of data or less. Each expression will be read as a 
16-bit word expression, the high-order byte to be 
truncated. The high-order byte must be either all 
zeros or a truncation (T) error results. 
Multiple expressions must be separated by commas. 



expn 

The .BYTE directive is used to generate successive bytes of binary 
data in the object module. 

Example: 



SAiyi=5 
.=410 



.BYTE 



'048, SAM 



THE VALUE 060 (OCTAL EQUIVALENT OF 48 
DECIMAL) IS STORED IN LOCATION 410. 
THE VALUE 005 IS STORED IN LOCATION 
411. 
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The construction 
illustrates the 
function of such special 
6.4.1,2. 



D in the first operand of the .BYTE directive above 

use of a temporary radix-control operator. The 

unary operators is described in Section 



At link time, it is likely that a relocatable expression will result 
in a value having more than eight bits, in which case the task builder 
or linker issues a truncation (T) error for the object module in 
question. For example, the following statements create such a 
possibility: 



A: 



.BYTE 23 
.BYTE A 



; STORES OCTAL 23 IN NEXT BYTE. 

; RELOCATABLE VALUE A WILL PROBABLY 
; CAUSE TRUNCATION ERROR. 



If an expression following the .BYTE directive is null, it is 
interpreted as a zero: 



=420 



.BYTE 



; ZEROS ARE STORED IN BYTES 420, 421, 
?422, AND 423. 



Note that in the above example, four bytes of storage result from the 
.BYTE directive. The three commas in the operand field represent an 
implicit declaration of four null values, each separated from the 
other by a comma. Hence, four bytes, each containing a value of zero 
(0) , are reserved in the object module. 



6.3.2 .WORD Directive 



.WORD 



Formats: 



.WORD 



exp 



; STORES THE BINARY EQUIVALENT OF THE 
; EXPRESSION EXP IN THE NEXT WORD. 



.WORD 



expl ,exp2,expn 



; STORES THE BINARY EQUIVALENTS OF THE 
;LIST OF EXPRESSIONS IN SUCCESSIVE 
; WORDS. 



where: exp, represent expressions that must reduce to 16 bits of 
expl, data or less. Multiple expressions must be separated 
by commas. 



expn 

The .WORD directive is used to generate successive words of data in 
the object module. 

Example: 



SAL=0 
.=500 



.WORD 177535,. +4, SAL ; STORES THE VALUES 177535, 506, AND 

;0 IN WORDS 500, 502, AND 504, 
;RESPECTIVELY. 
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If an expression following the .WORD directive contains a null value, 
it is interpreted as a zero, as shown in the following example: 



.=500 



.WORD 



,5, 



STORES THE VALUES 0, 5, AND IN 
LOCATION 500, 502, AND 504, 
RESPECTIVELY. 



A statement with a blank operator field (one that contains a symbol 
other than a macro call, an instruction mnemonic, a MACRO-11 
directive, or a semicolon) is interpreted during assembly as an 
implicit .WORD directive, as shown in the example below: 



.=440 
LABEL: 



100, LABEL 



; STORES THE VALUE 100 IN LOCATION 440 
;AND THE VALUE 440 IN LOCATION 442. 



CAUTION 

You should not use this technique to 
generate .WORD directives because it may 
not be included in future PDP-11 
assemblers. 



6.3.3 ASCII Conversion Characters 

The single quote (') and the double quote (") characters are unary 
operators that can appear in any MACRO-11 expression. Used in 
MACRO-11 expressions, these characters cause a 16-bit expression value 
to be generated. 

When the single quote is used, MACRO-11 takes the next character in 
the expression and converts it from its 7-bit ASCII value to a 16-bit 
expression value. The high-order byte of the resulting expression 
value is always zero (0) . The 16-bit value is then used as an 
absolute term within the expression. For example, the statement: 

MOV #'a,ro 

moves the following 16-bit expression value into register 0: 



00000000 



01000001 



L 



Binary Value of ASCII A 



Thus the expression 'A results in a value of 101(8). 

The single quote (') character must not be followed by a 
carriage-return, null, RUBOUT, line-feed, or form-feed character; if 
it is, an error code (A) is generated in the assembly listing. 
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When the double quote is used, MACRO-11 takes the next two characters 
in the expression and converts them to a 16-bit binary expression 
value from their 7-bit ASCII values. This 16-bit value is then used 
as an absolute term within the expression. For example, the 
statement: 

MOV #"AB,RO 

moves the following 16-bit expression value into register 0: 



01000010 01000001 



^— Binar\ 



:y Value of ASCII A 
-Binary Value of ASCII B 

Thus the expression "AB results in a value of 041101(8). 

The double quote {") character, like the single quote (') character, 
must not be followed by a carriage-return, null, RUBOUT, line-feed, or 
form-feed character; if it is, an error code (A) is generated in the 
assembly listing. 

The ASCII character set is listed in Appendix A.l. 



.ASCII 



6.3.4 .ASCII Directive 

Format: 

.ASCII /string 1/... /string n/ 

where: string is a string of printable ASCII characters. The 
vertical-tab, null, line-feed, RUBOUT, and all other 
non-printable ASCII characters, except carriage-return 
and form-feed, cause an error code (I) if used in an 
.ASCII string. The carriage-return and form-feed 
characters are flagged with an error code (A) because 
these characters end the scan of the line, preventing 
MACRO-11 from detecting the matching delimiter at the 
end of the character string. 

/ / represent delimiting characters. These delimiters may 

be any paired printing characters, other than the 
equal sign (=) , the left angle bracket (<) , or the 
semicolon (;) (see Note at end of section), as long as 
the delimiting character is not contained within the 
text string itself. If the delimiting characters do 
not match, or if an illegal delimiting character is 
used, the .ASCII directive is flagged with an error 
code (A) in the assembly listing. 



6-24 



GENERAL ASSEMBLER DIRECTIVES 



The .ASCII directive translates character strings into their 7-bit 
ASCII equivalents and stores them in the object module. A 
non-printing character can be expressed only by enclosing its 
equivalent octal value within angle brackets. Each set of angle 
brackets so used represents a single character. For example, in the 
following statement: 



.ASCII <15>/ABC/<A+2>/DEF/<5><4> 

the expressions <15>, <A+2>, <5>, and <4> represent the values of 
non-printing characters. Each bracketed expression must reduce to 
eight bits of absolute data or less. 

Angle brackets can be embedded between delimiting characters in the 
character string, but angle brackets so used do not take on their 
usual significance as delimiters for non-printing characters. For 
example, the statement: 

.ASCII /ABC<expression>DEF/ 

contains a single ASCII character string, and performs no evaluation 
of the embedded, bracketed expression. This use of the angle brackets 
is shown in the third example of the .ASCII directive below: 



.ASCII /HELLO/ 



; STORES THE BINARY REPRESENTATION 
;0F THE LETTERS HELLO IN FIVE 
; CONSECUTIVE BYTES. 



.ASCII /ABC/<15><12>/DEF/ ; STORES THE BINARY REPRESENTATION 

;0F THE CHARACTERS A,B ,C .CARRIAGE 
;RETURN,LINE FEED,D,E,F IN EIGHT 
; CONSECUTIVE BYTES. 



.ASCII /A<15>B/ 



; STORES THE BINARY REPRESENTATION 
;0F THE CHARACTERS A, <, 1, 5, >, 
;AND B IN SIX CONSECUTIVE BYTES. 



NOTE 

The semicolon (;) and equal sign (=) can 
be used as delimiting characters in the 
string, but care must be exercised in so 
doing because of their significance as a 
comment indicator and assignment 
operator, respectively, as illustrated 
in the examples below: 



.ASCII ;ABC;/DEF/ 



STORES THE BINARY 
REPRESENTATION OF 
THE CHARACTERS 
A, B, C, D, E, AND 
F IN SIX 

CONSECUTIVE BYTES; 
NOT RECOMMENDED 
PRACTICE. 



•ASCII /ABC/;DEF; 



STORES THE BINARY 
REPRESENTATIONS OF 
THE CHARACTERS A, 
B, AND C IN THREE 
CONSECUTIVE BYTES; 
THE CHARACTERS D, 
E, F, AND ; ARE 
TREATED AS A 
COMMENT. 
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.ASCII /ABC/=DEF= 



STORES THE BINARY 
REPRESENTATION OF 
THE CHARACTERS A, 
B, C, D, E, AND 
F IN SIX 

CONSECUTIVE BYTES; 
NOT RECOMMENDED 
PRACTICE. 



An equal sign is treated as an assignment operator when 
it appears as the first character in the ASCII string, 
as illustrated by the following example: 



.ASCII =DEF= 



THE DIRECT 
ASSIGNMENT 
OPERATION 
.ASCII=DEF IS 
PERFORMED, AND A 
SYNTAX ERROR (Q) 
IS GENERATED UPON 
ENCOUNTERING THE 
SECOND = SIGN. 



6.3.5 .ASCIZ Directive 



.ASCIZ 



Format; 



.ASCIZ /string 1/,.. /string n/ 



where: string 



/ / 



is a string of printable ASCII characters. The 
vertical-tab, null, line-feed, RUBOUT, and all other 
non-printable ASCII characters, except carriage-return 
and form-feed, cause an error code (I) if used in an 
.ASCIZ string. The carriage-return and form-feed 
characters are flagged with an error code (A) because 
they end the scan of the line, preventing MACRO-11 
from detecting the matching delimiter. 

represent delimiting characters. These delimiters may 
be any paired printing characters, other than the 
equal sign {-) , the left angle bracket (<) , or the 
semicolon (;) (see Note in Section 6.3.4), as long as 
the delimiting character is not contained within the 
text string itself. If the delimiting characters do 
not match or if an illegal delimiting character is 
used, the .ASCIZ directive is flagged with an error 
code (A) in the assembly listing. 
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The .ASCIZ directive is similar to the .ASCII directive described 
above, except that a zero byte is automatically inserted as the final 
character of the string. Thus, when a list or text string has been 
created with an .ASCIZ directive, a search for the null character in 
the last byte can effectively determine the end of the string, as 
reflected by the coding below: 



CR=15 
LF=12 
HELLO: 



10$: 



ASCIZ 
EVEN 



MOV 
MOV 
MOVE 
BNE 



<CR><LF>/MACR0-11 V01A/<CR><LF> ; INTRODUCTORY MESSAGE 



#HELL0,R1 ;GET ADDRESS OF MESSAGE. 

#LINBUF,R2 ;GET ADDRESS OF OUTPUT BUFFER. 

(Rl)+,(R2)+ ;MOVE A BYTE TO OUTPUT BUFFER. 

10$ ;IF NOT NULL, MOVE ANOTHER BYTE. 



6.3.6 .RAD50 Directive 



.RAD50 



Format! 



.RAD50 /string 1/... /string n/ 



where: string 



represents a series of characters to be packed. The 
string must consist of the characters A through Z, 
through 9, dollar sign ($) , period (.) and space ( ). 
An illegal printing character causes an error flag (Q) 
to be printed in the assembly listing. 

If fewer than three characters are to be packed, the 
string is packed left-justified within the word, and 
trailing spaces are assumed. 

As with the .ASCII directive (described in Section 
6.3.4), the vertical-tab, null, line-feed, RUBOUT, and 
all other non-printing characters, except 
carriage-return and form-feed, cause an error code (I) 
if used in a .RAD50 string. The carriage-return and 
form-feed characters result in an error code (A) 
because these characters end the scan of the line, 
preventing MACRO-11 from detecting the matching 
delimiter . 



represent delimiting characters. 
be any paired printing charac 
equal sign (=) , the left angle b 
semicolon (;) (see Note in Sec 
that the delimiting character is 
the text string itself. If the 
do not match or if an illegal del 
used, the .RAD50 directive is 
code (A) in the assembly listing. 



These delimiters may 
ters, other than the 
racket (<) , or the 
tion 6.3.4), provided 
not contained within 
delimiting characters 
imiting character is 
flagged with an error 
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The .RAD50 directive allows the user to generate data in Radix-50 
packed format. Radix-50 form allows three characters to be packed 
into sixteen bits (one word); therefore, any 6-character symbol can 
be stored in two consecutive words. Examples of .RAD50 directives are 
shown below: 



.RAD 50 /ABC/ 

.RAD 50 /AB/ 

.RAD 50 /ABCD/ 

.RAD50 /ABCDEF/ 



; PACKS ABC INTO ONE WORD. 

; PACKS AB (SPACE) INTO ONE WORD. 

; PACKS ABC INTO FIRST WORD AND 

;D (SPACE) (SPACE) INTO SECOND WORD, 

; PACKS ABC INTO FIRST WORD, DEF INTO 

; SECOND WORD. 



Each character is translated into its Radix-50 equivalent, 
indicated in the following table: 

Character Radix-50 Octal Equivalent 

(space) 

A-Z 1-32 

$ 33 

. - 34 

(undefined) 35 

0-9 36-47 



as 



The Radix-50 equivalents for characters 1 through 3 
combined as follows: 



(C1,C2,C3) are 



Radix-50 Value = ( (Cl*50) +C2) *50+C3 
For example: 

Radix-50 Value of ABC = ( (1*50) +2) *50+3 = 3223(8) 

Refer to Appendix A. 2 for a table of Radix-50 equivalents. 

Angle brackets (<>) must be used in the .RAD50 directive whenever 
special codes are to be inserted in the text string, as shown in the 
example below: 



.RAD50 /AB/<35> 



; STORES 3255 IN ONE WORD. 



CHR1=1 
CHR2=2 
CHR3=3 



.RAD50 <CHR1><CHR2><CHR3> ;EQUIVALENT TO .RAD50 /ABC/. 

6.3.7 Temporary Radix-50 Control Operator 

Format: 



Rccc 
where: ccc 



of three characters to 



be 



16-bit Radix-50 value. If more than 



represents a maximum 

converted to a 

three characters are specified, any following the 

third character are ignored. If fewer than three are 

specified, it is assumed that the trailing characters 

arc* Klank-c 
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The "R operator specifies that an argument is to be converted to 
Radix-50 format. This allows up to three characters to be stored in 
one word. The following example shows how the "R operator might be 
used to pack a 3-character file type specifier (MAC) into a single 
16-bit word. 



MOV #"RMAC,FILEXT 



; STORE RAD50 MAC AS FILE EXTENSION 



The number sign (#) is used to indicate immediate data (data to be 
assembled directly into object code) . "R specifies that the 
characters MAC are to be converted to Radix-50. This value is then 
stored in location FILEXT. 



6.3.8 .PACKED Directive 



.PACKED 



Format: 



.PACKED decimal-string [ , symbol J 



where: decimal-string 



represents a decimal number from to 31(10) 
digits long. Each digit must be in the range 
to 9 . The number may have a sign, but it 
is not required and is not counted as a 
digit. 



svmbol 



is assigned a value equivalent to the 
of decimal digits in the string. 



n umber 



The .PACKED directive generates packed decimal data, 2 digits per 
byte. Arithmetic and operational properties of packed decimals are 
similar to those of nurneric strings. Below is an example of the 
.PACKED directive: 



.PACKED -12, PACK 
.PACKED +500 
. PACKRD (J 

.PACKED -0,SUH 
.PACKED 1234E6 



PACK GETS VALUE OF 2 

500 IS PACKED 

IS PACKED 

SUM GETS VALUE OF 1 

ILLEGAL PACKED DECIMAL NUMBER 

E6 WILL BE TREATED AS A VARIABLE 

AND GIVEN A VALUE OF 4 



6.4 RADIX AND NUMERIC CONTROL FACILITIES 



6.4.1 Radix Control and Unary Control Operators 

Any numeric or expression value in a MACRO-11 source program is read 
as an octal value by default. Occasionally, however, an alternate 
radix would be useful. By using the MACRO-11 facilities described 
below, a programmer may declare a radix to affect a term or an entire 
program depending on his needs. 



NOTE 

When two or more unary operators appear 
together, modifying the same term, the 
operators are applied to the term from 
right to left. 
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6.4,1.1 



.RADIX Directive 



.RADIX 



Format: 

•RADIX n 

where: n represents one of the three radices: 2, 8 or 10. Any 
value other than null or one of the three acceptable 
radices will cause an error code (A) in the assembly 
listing. If the argument n is not specified, the 
octal default radix is assumed. The argument (n) is 
always read as a decimal value. 

Numbers used in a MACRO-11 source program are initially considered to 
be octal values? however, with the .RADIX directive you can declare 
alternate radices applicable throughout the source program or within 
specific portions of the program. 

Any alternate radix declared in the source program through the .RADIX 
directive remains in effect until altered by the occurrence of another 
such directive, for example: 



.RADIX 10 



; BEGINS A SECTION OF CODE HAVING A 
;DECIMAL RADIX. 



.RADIX 



; REVERTS TO OCTAL RADIX. 



In general, macro definitions should not contain or rely on radix 
settings established with the .RADIX directive. Rather, temporary 
radix control operators should be used within a macro definition. 
Where a possible radix conflict exists within a macro definition or 
source program, it is recommended that the user specify numeric or 
expression values using the temporary radix control operators 
described below. 



6,4.1.2 Temporary Radix Control Operators 
Formats: 

"D"number" ("number" is evaluated as a decimal number) 
"0"number" ("number" is evaluated as an octal number) 
"B"number" ("number" is evaluated as a binary number) 

These three unary operators allow the user to establish an alternate 
radix for a single term. An alternate is useful because after you 
have specified a radix for a section of code or have decided to use 
the default octal radix, you may discover a number of cases where an 
alternate radix is more convenient or desirable (particularly within 
macro definitions) . Creating a mask word (used to check bit status) , 
for example, might best be accomplished through the use of a binary 
radix. 

Thus an alternate radix can be declared temporarily to meet a 
localized requirement in the source program. The temporary radix 
control operator may be used any time regardless of the radix in 

Q•P•FQ^^ r.r nl-l-ior raHnv r! or-1 a r a f 1 nn s wil-hin the nroaraiTl, RecaUSS the 
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operator affects only the term immediately following it, it may be 
used anywhere a numeric value is legal. The term (or expression) 
associated with the temporary radix control operator will be evaluated 
during assembly as a 16-bit entity. 

The expressions below are representative of the methods of specifying 
temporary radix control operators: 

"D123 ' Decimal radix 

"0 47 Octal Radix 

"b 00001101 Binary Radix 

''0<A+13> Octal Radix 

The up-arrow and the radix control operator may not be separated, but 
the radix control operator and the following term or express-ion can be 
separated by spaces or tabs for legibility or formatting purposes. A 
multi-element terra or expression that is to be interpreted in an 
alternate radix should be enclosed within angle brackets, as shown in 
the last of the four temporary radix control expressions above. 

The following example also illustrates the use of angle brackets to 
delimit an expression that is to be interpreted in an alternate radix. 
When using the temporary radix control operator only numeric values 
are affected. Any symbols used with the operator will be evaluated 
with respect to the radix in effect at their declaration. 



A=10 



.RADIX 10 

.WORD "O<A+10>*10 



When the temporary radix expression in the .WORD directive above is 
evaluated, it yields the following equivalent statement: 

.WORD 180. 

MACRO-11 also allows a temporary radix change to decimal by specifying 
a number, immediately followed by a decimal point (.), as shown below: 

100. Equivalent to 144(8) 

1376. Equivalent to 2540(8) 

128. Equivalent to 200(8) 

The above expression forms are equivalent in function to: 

"DlOO 

"D1376 

"D128 



6.4.2 Numeric Directives and Unary Control Operators 

Two storage, dijrectives and twso maveric :cantco,l fliperatosrs, ac^jav^ijlable 
to simplify , the use of. - t}ie ,f,lo,a,tin,gr,p!0.i,n,t. ,hax4ware, .on _t^l{e PbP-1,1. 
These facilities allow floating-point data to be created ^n the 
program, and- numeric vajlues to be ' compl^ented '• or 'treated as 
floating-point numbers. 

A f 1 03 1 in*^- ^^o int number is represented b^' a strirt'^ of decimal di^i^ts. 
The string (which can be a single digit in Ler^th) may contain an 
optional decimal point and may be followed by an optional exponent 
indicator in the form of the letter E and a signed decimal integer 
exponent. The number may not contain embedded blanks, tabs or angle 
brackets and may not be an expression. Such a string will result in 
one or more errors (A and/or Q) in the assembly listing. 
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The list of numeric representations below contains seven distinct, 
valid repcesentations of the same floating-point number: 

J 
■ 3. 

:■ .-a.O ■"■- : ■■ '■"■■ . ■.-..- ■ ■■■■: --:. 

.. 3<0E0 ■ ■■ ■ 

.■■■ .3E0. .".■■; 

.300E-2- 

As can be inferred j the list could be extended indefinitely (3d'0pE-3',- 
.03E2, etc.). A leading plus sign is optional ;(3.Q is considered to 
be +3.0 ) , A leading minus sign complements the sign bit . . No other 
operators are allowed (for example, 3.0+N is illegal) . 

All floating-point numbers are evaluated as' 64, bits in -the following 
format:- 

■.■■ 63^- ■ ez' ■ ^-ss' :.:.:5"4 ■ :"■ ' ■■ -o'::^ ■-. . /■ ^- - . ■ /.>■ v " ■ ■■■ r ■ -V. ; ^ 

S EEEEEEEE MMM. . . . . MMM , 

Mantissa (55 bits) 
Exponent (8 bits) 
Sign (1 bit) 

MACRO-11 returns a value of the appropriate size and precision via one 
of the floating-point directives. The values returned may be 
truncated or rounded (see Section 6.2). 

Floating-point numbers are normally rounded. That is, when a 
floating-point number exceeds the limits of the field in which it is 
to be stored, the high-order bit of the unretained word is added to 
the low-order bit of the retained word, as shown below. For example, 
if the number is to be stored in a 2-word field, but more than 32 bits 
are needed to express its exact value, the highest bit (32) of the 
unretained field is added to the least significant bit (0) of the 
retained field (see illustration below). The .ENABL FPT directive is 
used to enable floating-point truncation; .DSABL FPT is used to 
return to floating-point rounding (see Table 6-3) . 

Bit Bit Bit Bit 
^32 ' 5/ V?^ 3/ 

Retained Unretained 

field field 

lps69,70 All numeric operands associated with Floating Point Processor 
instructions are: automatically evaluated as single-word, decimal, 
floating-point values unless a temporary radix control operator is 
specified. For example, to add (floating) the octal constant 41040 to 
the contents of floating accumulator: zero, the following: instruction 
must be used; 

ADDF : #"041040, FO ' , 

where: FO is assumed to represent floating accura:ulator zero. 

Floating-point numbers are described in greater deitail in the 
applicable PDP-11 Processor Handbook. 
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6.4.2.1 Floating-Point Storage Directives 



.FLT2 



.FLT4 



Formats: 



.FLT2 argl,arg2, 

.FLT4 argl,arg2, . . . 



t.trt OV4* ai"rTi srrt J 



- V- ^ .A.^^Cl ■• 



LHC 



LIK^6 1. S 



as described in Section 6.4.2. Multiple 
arguments must be separated by commas. 



.FLT2 causes two words of storage to be generated for each argument, 
while .FLT4 generates four words of storage for each argument. As in 
the .WORD directive, the arguments are evaluated and the results 
stored in the object module. 



6.4.2.2 Temporary Numeric Control Operators; "C and "f - The "C 

unary operator allows you to specify an argument that is to be 
complemented as it is evaluated during assembly. The "F unary 
operator allows you to specify an argument that is a 1-word 
floating-point number. 

As with the radix control operators described above, the numeric 
control operator ("C) can be used anywhere in tne source program that 
an expression value is legal. Such a construction is evaluated by 
MACRO-11 as a 16-bit binary value before being complemented. For 
example, the following statement: 



TAG4: 



.WORD 



~C151 



causes the I's complement of the value 151 (octal) to be stored as a 
16-bit value in the program. The resulting value expressed in octal 
form is 177626(8) . 

Because the "C construction is a unary operator, the operator and its 
argument are regarded as a term. Thus, more than one unary operator 
may be applied to a single term. For example, the following 
construction: 

"C"D25 

causes the decimal value 25 to be complemented during assembly. The 
resulting binary value, when expressed in octal form, reduces to 
177746 (octal) . 

The term created through the use of the temporary numeric control 
operator can be used alone or in combination with other expression 
elements. For example, the following construction: 

"C2+6 



ud.1 t- J. li 



^uiiwuxvii f^y^ , 



<"C2>+6 

This expression is evaluated during assembly as the I's complement of 
2, plus the absolute value of 6. When these terms are combined, the 
resulting expression value generates a carry beyond the most 
significant bit, leaving 000003(8) as the reduced value. 
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As shown above, when the temporary numeric control operator and its 
argument are coded as a term within an expression, angle brackets 
should be used as delimiters to ensure precise evaluation and 
readability. 

"f, as stated above, is a unary operator for numeric control which 
allows you to specify an argument that is a 1-word floating-point 
number. For example, the following statement: 

A: MOV #"F3.7,R0 

creates a 1-word floating-point number at location A+2 containing the 
value 3.7 formatted as shown below. 

BIT 15 14 7 6 

S EEEEEEEE MMMMMHM 

Sign (1 bit) Exponent (8 bits) Mantissa (7 bits) 

The importance of ordering with respect to unary operators is shown 
below. 

"Fl.O = 040200 

"F-l.O = 140200 

-"FLO = 137600 

-'"F-1.0 = 037600 

The value created by the "^F unary operator and its argument is, like 
"^C and its argument, a term that can be used by itself or in an 
expression. For example:' 

is equivalent to: 
"C<"F6.2> 



Again, the use of angle brackets is advised. Expressions used as 
terms or arguments of a unary operator must be explicitly grouped. 



6.5 LOCATION COUNTER CONTROL DIRECTIVES 

The directives used in controlling the value of the current location 
counter and in reserving storage space in the object program are 
described in the following sections. 

Several MACRO-11 statements (listed below) may cause an odd number of 
bytes to be allocated: 

1. .BYTE directive 

2. .BLKB directive 

3. .ASCII or .ASCIZ directive 

4. .ODD directive 

5. .PACKED direct ivi6 

6. A direct assignment statement of the form .=.+expression, 
which results in the assignment of an odd address value. 
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In cases that yield an odd address value, the next word-boundaried 
instruction automatically forces the location counter to an even 
value, but that instruction is flagged with an error code (B) in the 
assembly listing. 



6,5.1 .EVEN Directive 



.EVEN 



J? KJ L Hi Q l^ 



.EVEN 

The .EVEN directive ensures that the current location counter contains 
an even value by adding 1 if the current value is odd. If the current 
location counter is already even, no action is taken. Any operands 
following an .EVEN directive are flagged with an error code (Q) in the 
assembly listing. 

The .EVEN directive is used as follows: 



.ASCIZ /THIS IS A TEST/ 



.EVEN 



.WORD 



XYZ 



; ENSURES THAT THE NEXT STATEMENT WILL 
; BEGIN ON A WORD BOUNDARY. 



6.5.2 .ODD Directive 



.ODD 



Format: 

.ODD 

The .ODD directive ensures that the current location counter contains 
an odd value by adding 1 if the current value is even. If the current 
location counter is already odd, no action is taken. Any operands 
following an .ODD directive are also flagged with an error code (Q) in 
the assembly listing. 



.BLKB 



6.5.3 .BLKB and .BLKW Directives 



.BLKW 



Formats: 



.BLKB 

.BLKW 



exp 
exp 
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where: exp represents the 
be reserved i 
that is defined 
an absolute 
specified in ei 
absolute value, 
code (A) in the 
should not be 
argument is pre 



specified number of bytes or words to 

n the object program. Any expression 

at assembly time and that reduces to 

value is legal. If the expression 

ther of these directives is not an 

the statement is flagged with an error 

assembly listing. These directives 

used without arguments. However, if no 

sent, a default value of 1 is assumed. 



The .BLKB directive reserves byte blocks in the object module; the 
.BLKW directive reserves word blocks. Figure 6-6 illustrates the use 
of the .BLKB and .BLKW directives. 



1 

2 
3 
4 000000 



6 000000 

7 

8 000002 

9 
10 000122 
11 

12 000123 
13 
14 000124 



f Illustrste use of .BLKB and .BLKU directives 
.PSECT IMPURE>D>GBL,RU 



C0UNT5 


.BLKU 


1 


iChsrscter counter 


hessag: 


.BLKB 


80, 


iMesss^e text buffer 


CHRSAVi 


.BLKB 




iSaved character 


FLAG! 


.BLKB 




iFlsg byte 


msgptr: 


.BLKU 




iHesss^e buffer pointer 



Figure 6-6 Example of .BLKB and .BLKW Directives 



The .BLKB directive in a source program has the same effect as the 
following statement: 

.=.+expression 

which causes the value of the expression to be added to the current 
value of the location counter. The .BLKB directive, however, is 
easier to interpret in the context of the source code in which it 
appears and is therefore recommended. 



6.5.4 .LIMIT Directive 



.LIMIT 



Format: 

.LIMIT 

To know the upper and lower address boundaries of the image is often 
desirable. When the .LIMIT directive is specified in the source 
program, MACRO-11 generates the following instruction: 

. BLKW 2 

causing two storage words to be reserved in the object module. Later, 
at link time, the lowest address in the load image (the initial value 
of SP) is inserted into the first reserved word, and the address of 
the first free word following the image is inserted into the second 
reserved word. 

During linking, the size of the image is rounded upward to the nearest 
2-word boundary. 
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6.6 TERMINATING DIRECTIVES 



.END 



6.6.1 .END Directive 
Format: 

.END [exp] 

where: exp represents an optional expression value which, if 
present, indicates the program-entry point, which is 
the transfer address where the program begins. 

When MACRO-11 encounters a valid occurrence of the .END directive, it 

terminates the current assembly pass. Any text beyond this point in 

the current source file, or in additional source files identified in 
the command line, will be ignored. 

When creating an image consisting of several object modules, only one 
object module may be terminated with an .END exp statement (where exp 
is the starting address) . All other object modules must be terminated 
with an .END statement (where .END has no argument); otherwise, an 
error message will be issued at link time. If no starting address is 
specified in any of the object modules, image execution will begin at 
location 1 of the image and immediately fault because of an odd 
addressing error. 

The .END statement must not be used within a macro expansion or a 
conditional assembly block; if it is so used, it is flagged with an 
error code (0) in the assembly listing. The .END statement may be 
used, however, in an immediate conditional statement (see Section 
6.9.3) . 

If the source program input is not terminated with an .END directive, 
an error code (E) results in the assembly listing. 



6.6.2 .EOT Directive 



.EOT 



under RSX-llM, RT-11 , RSTS and IAS operating systems, the MACRO-11 
.EOT (End of Tape) directive is ignored and simply treated as a 
directive without effect. 



6.7 PROGRAM SECTIONING DIRECTIVES 

The MACRO-11 program sectioning directives are used to declare names 
for program sections (p-sections) and to establish certain program 
section attributes essential to linking. 
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6.7.1 .PSECT Directive 

Format: 

.PSECT name,argl,arg2 , . . .argn 



.PSECT 



where: name 



argl, 
arg2, , 
argn 



represents the symbolic name of the program 
section, as described in Table 6-4. 

represents any legal separator (comma, tab and/or 
space) . 



represent one or more of the 
arguments defined for use with 
directive, as described in Table 6- 
separating each pair of symbolic a 
in the table indicates that one or 
not both, may be specified. Mul 
must be separated by a legal separa 
Any symbolic argument specified 
directive other than those listed 
will cause that statement to be 
error code (A) in the assembly list 



legal symbolic 
the .PSECT 
4. The slash 
rguments listed 
the other, but 
tiple arguments 
ting character. 
in the .PSECT 
in Table 6-4 
flagged with an 
ing. 



Table 6-4 
Symbolic Arguments of .PSECT Directive 



Argument 


Default 


Meaning 


NAME 


Blank 


Establishes the program section name, which 
is specified as one to six Radix-50 
characters. If this argument is omitted, a 
comma must appear in place of the name 
parameter. The Radix-50 character set is 
listed in Appendix A. 2. 


RO/RW 


RW 


Defines which type of access is permitted 
to the program section: 

RO=Read-Only Access 
RW=Read/Write Access 

NOTE 

RSX-llM and RT-11 use only 
Read/Write access. 



(continued on next page) 
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Table 6-4 (Cont.) 
Symbolic Arguments of .PSECT Directive 



Argument 



Default 



Meaning 



I/D 



GBL/LCL 



LCL 



Defines the 
section: 



contents 



of the 



program 



I=Instructions. If a p-section has the I 
attribute and the program is overlaid,- 
all calls to the p-section are referenced 
through a body of overlay code stored in 
the root. 

If a concatenated p-section has the I 
attribute, code is concatenated on even 
bytes. 

D=Data. If a p-section has the D 
attribute, all calls to the p-section are 
referenced directly. 

If a concatenated p-section has the D 
attribute, code is concatenated on the 
next byte regardless of whether the byte 
is odd or even. 

Defines the scope of the program section, 
as it will be interpreted at link time: 



NOTE 

The GBL/LCL arguments apply only in 
the case of overlays; in building 
single-segment nonoverlaid 
programs, the GBL/LCL arguments 

f^ax/g XIQ m'^^n"'n'^ Kor-aneo 4-l->o ^-r^^-a^ 

memory allocation for the program 
will go into the root segment of 
the image. 



LCL=Local. If an object module contains a 
local program section, then the storage 
allocation for that module will remain 
in the segment containing the module. 
Many modules can contribute (allocate 
memory) to this same program section; 
the memory allocation for each 
contributing module is either 
concatenated or overlaid within the 
segment, depending on the allocation 
argument of the program section {see 
CON/OVR below) . 



(continued on next page) 
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Table 6-4 (Cont.) 
Symbolic Arguments of .PSECT Directive 



Argument 



Default 



Meaning 



GBL/LCL 
(cont.) 



ABS/REL 



REL 



GBL=Global. If a global program section is 
used in more than one segment of a 
program, all references to the 
p-section are collected across segment 
boundaries. The program sections are 
then stored in the segment (of those 
originally containing the p-sections) 
that is nearest the root. 



NOTE 

RT-11 stores the collected 
p-sections in the root. 



Defines the relocatability attribute of the 
program section: 

ABS=Absolute (non-relocatable) . The ABS 
argument causes the linker or task 
builder to treat the p-section as an 
absolute module; therefore, no 
relocation is required. The program 
section is assembled and loaded, 
starting at absolute virtual address 0. 



The location 
program sect 
virtual memor 
containing 
otherwise, an 
time. For ex 
although val 
generate an 
virtual locat 
segment's vir 



.=.+100000 



of data in absolute 

ions must fall within the 

y limits of the segment 

the program section; 

error results at link 
ample, the following code, 
id during assembly, may 
error message (A) if 
ion 100000 is outside the 
tual address space: 

.PSECT ALPHA, ABS 

.WORD X 



REL=Relocatable. The REL argument causes 
the linker or task builder to treat the 
p-section as a relocatable module and a 
relocation bias is added to all 
location references within the program 
section making the references absolute. 



(continued on next page) 
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Table 6-4 (Cont.) 
Symbolic Arguments of .PSECT Directive 



Argument 




Default 


Meaning 


CON/OVR 


CON 


Defines the allocation requirements of the 
program section: 

CON=Concatenated. All references to one 
program section are concatenated to 
determine the total memory space needed 
for the p-section. 

OVR=Overlaid. All references to one 
program section are overlaid; the 
total memory space needed equaling the 
largest, individual p-section. 



The only argument in the .PSECT directive that is position-dependent 
is NAME. If it is omitted, a comma must be used in its place. For 
example, the directive: 

.PSECT ,GBL 

shows a .PSECT directive with a blank name argument and the GBL 
argument. Default values (see Table 6-4) are assumed for all other 
unspecified arguments. 

The .PSECT directive may be used without a name or arguments (see 
Section 6.7.1.1) . 

The .PSECT directive allows a user to create program sections (see 
Section 6.7.1.1) and to share code and data among the sections he has 
created (see Section 6.7.1.2). In declaring the program sections 
(also called p-sections) , you may declare the attributes of the 
p-sections. This allows you to control memory allocation and at the 
same time increases program modularity. (For a discussion of memory 
allocation, refer to the applicable system manual - see Section 0.3 in 
the Preface.) 

MACRO-11 provides for 256(10) program sections, as listed below: 

1. One default absolute program section (. ABS.) 

2. One default relocatable program section (. ELK.)* 

3. Two-hundred-fifty-four named program sections. 

For each program section specified or implied, MACRO-11 maintains the 
following information: 

1. Program section name 

2. Contents of the current location counter 

3. Maximum location counter value encountered 

4. Program section attributes (described in Table 6-4 above). 



In RT-11 this program section is unnamed 
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6.7.1,1 Creating Program Sections - The first statement of a source 
program is always an implied .PSECT directive; this causes MACRO-11 
to begin assembling source statements at relocatable zero of the 
unnamed program section. 

The first occurrence of a .PSECT directive with a given name assumes 
that the current location counter is set at relocatable zero. The 
scope of this directive then extends until a directive declaring a 
different program section is specified. Subsequent .PSECT directives 
cause assembly to resume where the named section previously ended. 
For example: 

.•DECLARES UNNAMED RELOCATABLE PROGRAM 
; SECTION ASSEMBLED AT RELOCATABLE 
;ADDRESSES 0,2, AND 4. 

; DECLARES RELOCATABLE PROGRAM SECTION 

; NAMED ALPHA ASSEMBLED AT RELOCATABLE 

; ADDRESSES AND 2. 

; RETURNS TO UNNAMED RELOCATABLE 

; PROGRAM SECTION AND CONTINUES ASSEM- 

;BLY AT RELOCATABLE ADDRESS 6. 

A given program section may be defined completely upon encountering 
its first .PSECT directive. Thereafter, the section can be referenced 
by specifying its name only, or by completely respecifying its 
attributes. For example, a program section can be declared through 
the directive: 

.PSECT ALPHA, ABS,OVR 

and later referenced through the equivalent directive: 





.PSECT 




A: 


.WORD 





B: 


.WORD 





C: 


.WORD 







.PSECT 


ALPHA 


X: 


.WORD 





Y: 


.WORD 
.PSECT 





D: 


.WORD 






.PSECT ALPHA 

which requires no arguments. If arguments are specified, they must be 
identical to the ones previously declared for the p-section. If the 
arguments differ, the arguments of the first .PSECT will remain in 
effect, and an error code (A) will be generated as a warning. 

By maintaining separate location counters for each program section, 
MACRO-11 allows you to write statements that are not physically 
sequential but that can be loaded sequentially following assembly, as 
shown in the following example. 

; START A RELOCATABLE PROGRAM SECTION 
;NAMED SECl ASSEMBLED AT RELOCATABLE 
; ADDRESSES 0,2, AND 4. 

; ASSEMBLE CODE AT RELOCATABLE 
;ADDRESSES 6 THROUGH 12. 

; START AN ABSOLUTE PROGRAM SECTION 

; NAMED SECA. ASSEMBLE CODE AT 

; ABSOLUTE ADDRESSES AND 2. 

; RESUME RELOCATABLE PROGRAM SECTION 

;SEC1. ASSEMBLE CODE AT RELOCATABLE 

; ADDRESSES 14 AND 15. 

All labels in an absolute program section ace absolute; likewise, all 
labels in a relocatable section are relocatable. The current location 
counter symbol (.) is relocatable or absolute when referenced in a 
relocatable or absolute program section, respectively. 





.PSECT 


SEC1,REL,R0 


A: 


.WORD 





B: 


.WORD 





C: 


.WORD 





ST: 


CLR 


A 




CLR 


B 




CLR 


C 




.PSECT 


SECA,ABS 




.WORD 


.+2, A 




.PSECT 


SECl 




INC 


A 




BR 


ST 
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Any labels appearing on a line containing a .PSECT (or .ASECT or 
.CSECT) directive are assigned the value of the current location 
counter before the .PSECT (or other) directive takes effect. Thus, if 
the first statement of a program is: 



A: 



.PSECT ALT,REL 



the label A is assigned to relocatable address zero 
program section. 



of the unnamed 



Since it is not known during assembly where relocatable program 
sections will be loaded, all references to relocatable program 

-1^ i U1»J — ^ *^».r»^»«^A<-t ^ ^1 -^t- A rT^ *- fy 4-K>^ K^^A r\^ 4-1^.^ 

referenced section. 

In the following example, references to the symbols X and Y are 
translated into references relative to the base of the relocatable 
program section named SEN. 



.PSECT ENT,ABS 



.=.+1000 

A: CLR 


X ; 


JMP 


Y ; 


•PSECT 
MOV 
JMP 
y : HALT 
X: .WORD 


SEN,REL 
R0,R1 

A ; 





ASSEMBLED AS CLR BASE OF 
RELOCATABLE SECTION + 10(8) 
ASSEMBLED AS JMP BASE OF 
RELOCATABLE SECTION + 6(8). 



jASSEMBLED AS JMP 1000. 



NOTE 

In the preceding example, using a 
constant in conjunction with the current 
location counter symbol (.) in the form 
.=1000 would result in an error, because 
constants are always absolute and are 
always associated with the program's 
.ASECT (. ABS.). If the form .=1000 
were used, a program section 
incompatibility would be detected. See 
Section 3.6 for a discussion of the 
current location counter. 



Thus, MACRO-11 provides the linker or task builder with the necessary 
information to resolve the linkages between various program sections. 
Such information is not necessary, however, when referencing an 
absolute program section, because all instructions in an absolute 
program section are associated with an absolute virtual address. 



6.7.1.2 Code or Data Sharing - Named relocatable program sections 
with the arguments GBL and OVR operate in the same manner as FORTRAN 
COMMON, that is, program sections of the same name with the arguments 
GBL and OVR from different assemblies are all loaded at the same 
location at link time. All other program sections (those with the 
argument CON) are concatenated. 
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A single symbol could name both an internal symbol and a program 
section. Considering FORTRAN again, using the same symbolic name is 
necessary to accommodate the following statement: 

COMMON /X/ A,B,C,X 

where the symbol X represents the base of the program section and also 
the fourth element of that section. 



6.7.1.3 Memory Allocation Considerations - The assembler does not 
generate an error when a module ends at an odd location. You can, 
therefore, place odd length data at the end of a module. However, 
when several modules contain object code contributions to the same 
program section having the concatenate attribute (see Table 6-4; 
CON/OVR) , odd length modules (except the last) may cause succeeding 
modules to be linked starting at odd locations, thereby making the 
linked program unexecutable. To avoid this problem, separate code and 
data from each other and place them in separately named program 
sections (see Table 6-4; I/D) . The linker or task builder can then 
begin each program section on an even address. Refer to the 
applicable system manual for further information on memory allocation 
of tasks (see Section 0.3 in the Preface). 



6.7.2 .ASECT and .CSECT Directives 



Formats: 



ASECT 



CSECT 



.ASECT 
.CSECT 
.CSECT symbol 

where: symbol represents one or more of the arguments in Table 6-4. 

IAS and RSX-llM assembly-language programs use the .PSECT and .ASECT 
directives exclusively, because the .PSECT directive provides all the 
capabilities of the .CSECT directive defined for other PDP-11 
assemblers. MACRO-11 will accept both .ASECT and .CSECT directives, 
but assembles them as though they were -PSECT directives with the 
default attributes listed in Table 6-5. Compatibility exists between 
other MACRO-11 programs and the lAS/RSX-llM Task Builders, because the 
Task Builders also treat the .ASECT and .CSECT directives like .PSECT 
directives with the default values listed in Table 6-5. 
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Table 6-5 
ProQrani Section Defsult Vslues 







Default Value 




Attribute 








.ASECT 


•CSECT (named) 


.CSECT (unnamed) 


Name 


. ABS, 


name 


. BLK.* 


ACCESS 


RW 


RW 


RW 


Type 


I 


I 


I 


Scope 


GBL 


GBL 


LCL 


Relocation 


ABS 


REL 


REL 


Allocation 


OVR 


OVR 


CON 



Note that the statement: 

.CSECT JIM 
is identical to the statement: 

.PSECT JIM, GBL, OVR 

because the .CSECT default values GBL and OVR are assumed for the 
named program section. 



6.7.3 .SAVE Directive 



SAVE 



Format: 

.SAVE 

.SAVE stores the current program section context on the top of the 

section context in effect. If the stack is full when .SAVE is issued, 
an error (A) occurs. The stack can handle 16 .SAVEs, The program 
section context ,i_acludes the values of .the current location counter 
and the maximum value assigned to the location counter in the current 
program section. 

See Figure 6-7 for an example of .SAVE 



* In RT-11 this program section has no default name. 
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.RESTORE 



6.7.4 .RESTORE Directive 

Format: 

.RESTORE 

The .RESTORK directive retrieves the program section from the top of 
the proqram section context stack. If the stack is empty when 
.RESTORE is issued, an error (A) occurs. When .RESTORE retrieves a 
program section, it restores the current location counter to the value 
it had when the program section was saved. 

See Figure 6-7 for an example of .RESTORE. 



6-46 



GENERAL ASSEMBLER DIRECTIVES 



w 
a. 



in 

0) 

> 



01 

■m 
n 
« 

a 

o 



111 

(0 



Ul ' 



•r^ Ul 

i- ta 

u o a. 

Ul £ 

0. o c 

c re 01 

^> -n iL t- 

C Mk s- 

a 3 
(• V 01 u 
C- to JC 

3 TO »> « 

u jc 

HI 01 V 

a JC TO 

^ in 01 

01 n «> 

01 c- c 
> O ■•» Ol 
re -p 01 01 
en tn (A a: 







t- 


Si 






01 


01 


m 






r-l 


** 


^ 


in 




JO 


c 




in 




re 


•H 


01 


01 




*> 


o 


£ 


(- 






<L 


t) 


■0 




«- 






13 




o 


01 
M 


Ul 


re 




01 


•M 


re 


T! 




in 




dL 


C 


>tl 


re 


re 




01 


01 


JQ 


-H 


-«j 




■M 




** 


c 


01 


C 


■p 


■H 


-rt 


> 


-P 


01 


c 


O 


a 


c 


cs 


l-H 


a. 


O) 


01 


•■■ 


"* 


'•■ 


"* 






01 


V 


jQ 


■p 


in o 


■ 


c 


01 


31 


■H 


<a in 


IK 


o 


ai Ul 




0. 


JQ 01 


t- 




c 


n 


r^ 


• TO 







01 TO 


in 


JQ 


r^ re 


Dl 


e 


£ 


01 


01 


re TO 


t- 


in 


«5 C 


X} 




01 


•0 


-P 


4- 


ro 


c 


o o 




01 


-p 


01 


c 


01 


ill 


i- 


N ^ 


re 


3 


■^ 01 


A 


U 


CO en 



cs 



M 


in 




T 


*^ 


Ui 


0^ cs 


r^ « 


1 en 


_i = 


3 


-) UJ 


1 o: 


(S o 







re 


£ 


a 






> 






^ 




b 


« 


cs 












o 




o 


Z 


a 






a 


w :c ^ ei- 
oc > a: o 




01 




(0 










^ 


.. en - 1- 




f~l 








Ul 








cnCE N x: 




fl. 




01 




oe 






01 


« 3 M > 




E 




c 




3UJ 








m o en CO 


• 


re 




3 




a-N 






JQ 


:c - t - 


* 


X 




fiL 


CD 


>: '-' 






re 


> -< V "H 


• 


UJ 




G 


Q 


HH en 

Ul 






4> 
£ 


cn o: en ce 


01 

c 


«j 




»-* 


O 


1- o 






in 




♦> 


h> 




re 


ce UJ CJ 3 1- 


z 




re 




3 


h- 




CJ 


cj ^ UJ i£ en 


o 




£ 




o 


n 




o^ 


« « en -J lij 


z 






z>'> a z> 


t~ 


tn 


CO 


r-l 


s en a. n a: 


Ul 




01 


oo ao 









01 

c 




■ • • • 




>- 


£ 


t >: « r 


4- 
o 




i> 


■H 








z 


C 


>- 


^ 




o 


V 




«* 




« 


re 


en 


in 




re 


01 




UJ 




o 


ei 


z 


01 




c 


o 




z 




en 


en 


« 


DC 



o 

jQ 

E 
31 



en :c N 0- 

« > l-l o 

n en CO I- 

E cc 1 1: 

>- = > > 

en u en eo 



en en en en 

o o Q e 



o 



!- O 

a: V 

o b 

en 01 



U 
(LI 

>-i 



O 

u 



f3 



> 

< 



M-l 

o 



a. 

E 
(0 

x; 



I 






o a: 
o • 
• V. 

o :> 
>- « 

o ~ 

CJ u. 
<x o 



Z 0. 

<I <I 

■Z. X 

• UJ 



O CM T *0 

O Ci o o 

o o o o 

o o o o 

o o o o 

o o o o 



»-( r^ iH IS 

o ^ o ^ 

rs ^ rs ^ 

-O ik^ ^ o 

W rH >0 ^ 

o o o o 



O >» O T 

O O ^^ T^ 

o o o o 

o o o o 

o o o o 

o o o o 



T-i rj rj rj 

CJ rj CJ r-i 

o o o o 

o o o o 

o o o o 

o o o o 



o 

o 
o 
o 
o 



o 

IS 






o 
o 



o 
o 



wMro^iO'Oisoo&'OwcjM^in'OisaoO'O'-tf'iM^iii^fscocso^wM^ijT^rscD&'O^c-jn^insjiscD 



6-47 



GENERAL ASSEMBLER DIRECTIVES 



6.8 SYMBOL CONTROL DIRECTIVE 
Format: 



GLOBL 



.GLOBL syml , syni2 , . . . symn 



where: syml, 
sym2 , , 
symn 



represent legal symbolic names, when multiple 
symbols are specified, they are separated by any 
legal separator (comma, space, and/or tab). 



A .GLOBL directive may also embody a 
field. 



label field and/or a comment 



The .GLOBL directive is provided to define (and thus provide linkage 
to) symbols not otherwise defined as global symbols within a module. 
In defining global symbols the directive .GLOBL A,B,C is similar to: 

A==:expression A==expression A:: 
B==:expression or B==expression or B:: 
C==: expression C==expression C:: 

Because object modules are linked by global symbols, these symbols are 
vital to a program. The following paragraph, describing the 
processing of a program from assembly to linking, explains the 
global's role. 



In assembling 
module and a 
table. The li 
modules into 
modules are re 
global symbol 
program module 
defining modu 
assignment ope 
global . 



a source program, MACRO-1 

listing file containing 
nker or task builder join 
a single executable i 
located relative to the b 
s. Because these symb 
s, they must be singled o 
les. As shown above, 
rator, or global label op 



1 prod 


uces a r 


the assembly 1 


s separately 


mage. 


During 


ase of 


the mod 


ols wi 


11 be re 


ut as 


global 


the 


.GLOBL 


erator 


will de 



elocatable object 
isting and symbol 
assembled object 
linking, object 
ule and linked by 
ferenced by other 
symbols in the 
directive, global 
fine a symbol as 



All internal symbols appearing within a given program must be defined 
at the end of assembly pass 1 or they will be assumed to be default 
global references. Refer to Section 6.2 for a description of 
enabling/disabling of global references. 

In the following example, A and B are entry-point symbols. The symbol 
A has been explicitly defined as a global symbol by means of the 
.GLOBL directive, and the symbol . B has been explicitly defined as a 
global label by means of the double colon (::). Since the symbol C is 
not defined as a label within the current assembly, it is an external 
(global) reference if . ENABL GBL is in effect. 



DEFINE A SUBROUTINE WITH 2 ENTRY POINTS WHICH CALLS AN 
EXTERNAL SUBROUTINE 



A: 
X: 

B? ! 



.PSECT 




.GLOBL 


A 


MOV 


@(R5) 


MOV 


#X,R1 


JSR 


PC,C 


RTS 


R5 


MOV 


{R51 + 


CLR 


R2 


BR 


X 



.Rl 



; DECLARE THE UNNAMED PROGRAM SECTION, 
; DEFINE A AS A GLOBAL SYMBOL. 
; DEFINE ENTRY POINT A. 

;CALL EXTERNAL SUBROUTINE C. 
;EXIT. 
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External symbols can appear in the operand field of an instruction or 
MACRO-11 directive as a direct reference, as shown in the examples 
below: 

CLR EXT 
.WORD EXT 
CLR @EXT 



External symbols may also appear as a 
shown below: 



term within an expression, as 



CLR EXT+A 
.WORD EXT- 2 
CLR @EXT+A(R1) 

An undefined external symbol cannot be used in the evaluation of a 
direct assignment statement or as an argument in a conditional 
assembly directive (see Sections 3.3, 6.9.1 and 6.9.3). 



6.9 CONDITIONAL ASSEMBLY DIRECTIVES 

Conditional assembly directives allow you to include or exclude blocks 
of source code during the assembly process, based on the evaluation of 
stated condition tests within the body of the program. 



6.9.1 Conditional Assembly Block Directives 



ENDC 



Format: 



,IF cond, argument (s) ;START CONDITIONAL ASSEMBLY BLOCK. 



range 



; RANGE OF CONDITIONAL ASSEMBLY BLOCK. 



.ENDC 
where: cond 



;END OF CONDITIONAL ASSEMBLY BLOCK. 

represents a specified condition that must 
be met if the block is to be included in the 
assembly. The conditions that may be tested 
by the conditional assembly directives are 
defined in Table 6-6. 



represents any legal 
space, and/or tab). 



separator (comma, 



argument (s) 



represent (s) the symbolic argument (s) or 
expression(s) of the specified conditional 
test. These arguments are thus a function 
of the condition to be tested (see Table 
6-6) . 
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represents the body of code that is either 
included in the assembly, or excluded, 
depending upon whether the condition is met. 

terminates the conditional assembly block. 
This directive must be present to end the 
conditional assembly block. 



A condition test other than those listed in Table 6-6, an illegal 
argument, or a null argument specified in an .IF directive causes that 
line to be flagged with an error code (A) in the assembly listing. 



Table 6-6 
Legal Condition Tests for Conditional Assembly Directives 



Conditions 


Positive 


Complement 


Arguments 


Assemble Block If: 


EQ 


NE 


Expression 


Expression is equal to 
(or not equal to 0) . 


GT 


LE 


Expression 


Expression is greater 
than (or less than or 
equal to 0) . 


LT 


GE 


Expression 


Expression is less than 
(or greater than or equal 
to 0) . 


DF 


NDF 


Symbolic 
argument 


Symbol is defined (or not 
defined) . 


B 


NB 


Macro-type 
argument 


Argument is blank (or 
non-blank) . 


IDN 


DIF 


Two macro-type 
arguments 


Arguments are identical 
(or different) . 


Z 


NZ 


Expression 


Same as EQ/NE. 


G 


L 


Expression 


Same as GT/LT. 



NOTE 

A macro-type argument (which is a form 
of symbolic argument) , as shown below, 
is enclosed within angle brackets or 
denoted with an up-arrow construction 
(as described in Section 7.3). 

<A,B,C> 
V124/ 
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An example of a conditional assembly directive follows: 

.IF EQ ALPHA+1 ; ASSEMBLE BLOCK IF ALPHA+1=0 , 



.ENDC 

The two operators & and ! have special meaning within DF and NDF 
conditions, in that they are allowed in grouping symbolic arguments, 

& Logical AND operator 

1 Logical inclusive OR operator 

For example, the conditional assembly statement: 

.IF DF SYMl & SYM2 



• ENDC 

results in the assembly of the conditional block if the symbols SYMl 
and SYM2 are both defined. 

Nested conditional directives take the form: 

Conditional Assembly Directive 
Conditional Assembly Directive 



.ENDC 
.ENDC 



For example, the following conditional directives: 

.IF DF SYMl 
.IF DF SYM2 



.ENDC 
.ENDC 

can govern whether assembly is to occur. In the example above, if the 
outermost condition is unsatisfied, no deeper level of evaluation of 
nested conditional statements within the program occurs. 

Each conditional assembly block must be terminated with an .ENDC 
directive. An .ENDC directive encountered outside a conditional 
assembly block is flagged with an error code (0) in the assembly 
listing. 

MACRO-11 permits a nesting depth of 16(10) conditional assembly 
levels. Any statement that attempts to exceed this nesting level 
depth is flagged with an error code (0) in the assembly listing. 
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IFF 



IFT 



6.9.2 Subconditional Assembly Block Directives 

Formats: 



.IFTF 



.IFF 
.IFT 
.IFTF 

Subconditional directives may be placed within conditional assembly 
blocks to indicate: 

1. The assembly of an alternate body of code when the condition 
of the block tests false, 

2. The assembly of a non-contiguous body of code within the 
conditional assembly block, depending upon the result of the 
conditional test in entering the block. 



The unconditional assembly of a 
conditional assembly block. 



body of code within a 



The subconditional directives are described in detail in Table 6-7. 
If a subconditional directive appears outside a conditional assembly 
block, an error code (0) is generated in the assembly listing. 



Table 6-7 
Subconditional Assembly Block Directives 



Subconditional 
Directive 


Function 


.IFF 
.IFT 
.IFTF 


If the condition tested upon entering the 
conditional assembly block is false, the code 
following this directive, and continuing up to the 
next occurrence of a subconditional directive or 
to the end of the conditional assembly block, is 
to be included in the program. 

If the condition tested upon entering the 
conditional assembly block is true, the code 
following this directive, and continuing up to the 
next occurrence of a subconditional directive or 
to the end of the conditional assembly block, is 
to be included in the program. 

The code following this directive, and continuing 
up to the next occurrence of a subconditional 
directive or to the end of the conditional 
assembly block, is to be included in the program, 
regardless of the result of the condition tested 
upon entering the conditional assembly block. 
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The implied argument of a subconditional directive is the condition 
test specified upon entering the conditional assembly block, as 
reflected by the initial directive in the conditional coding examples 
below. Conditional or subconditional directives in nested conditional 
assembly blocks are not evaluated if the previous (or outer) condition 
in the block is not satisfied. Examples 3 and 4 below illustrate 
nested directives that are not evaluated because of previous 
unsatisfied conditional coding. 



EXAMPLE 1: Assume that symbol SYM is defined. 
.IF DF SYM 



; TESTS TRUE, SYM IS DEFINED, ASSEMBLE 
;THE FOLLOWING CODE. 



,IFF 



; TESTS FALSE. SYM IS DEFINED. DO NOT 
; ASSEMBLE THE FOLLOWING CODE. 



, IFT 



; TESTS TRUE. SYM IS DEFINED. ASSEM- 
;BLE THE FOLLOWING CODE. 



, IFTF 



;ASSEMBLE FOLLOWING CODE UNCONDITION- 
;ALLY. 



, IFT 



; TESTS TRUE. SYM IS DEFINED. ASSEM- 
;BLE REMAINDER OF CONDITIONAL ASSEM- 
;BLY BLOCK. 



.ENDC 



EXAMPLE 2: Assume that symbol X is defined and that symbol Y is not 
defined. 



.IF DF 
.IF DF 



X 

Y 



TESTS TRUE, SYMBOL X IS DEFINED. 
TESTS FALSE, SYMBOL Y IS NOT DEFINED. 
TESTS TRUE, SYMBOL Y IS NOT DEFINED, 
ASSEMBLE THE FOLLOWING CODE. 



.IFT 



; TESTS FALSE, SYMBOL Y IS NOT DEFINED, 
;D0 NOT ASSEMBLE THE FOLLOWING CODE, 



,ENDC 
,ENDC 
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EXAMPLE 3: Assume that symbol A is defined and that symbol B is not 
defined. 

.IF DF A ; TESTS TRUE. A IS DEFINED. 

; ASSEMBLE THE FOLLOWING CODE. 
MOV A,R1 



•IFF ; TESTS FALSE. A IS DEFINED. DO NOT 

; ASSEMBLE THE FOLLOWING CODE. 
MOV Rl,RO 



,IF NDF B ; NESTED CONDITIONAL DIRECTIVE IS NOT 

; EVALUATED . 



.ENDC 
,ENDC 



EXAMPLE 4: Assume that symbol X is not defined and that symbol Y is 
defined. 

.IF DF X ; TESTS FALSE. SYMBOL X IS NOT DEFINED. 

;D0 NOT ASSEMBLE THE FOLLOWING CODE. 
.IF DF Y ;NESTED CONDITIONAL DIRECTIVE IS NOT 

; EVALUATED . 

.IFF ; NESTED SUBCONDITIONAL DIRECTIVE IS 

;NOT EVALUATED. 

.IFT ; NESTED SUBCONDITIONAL DIRECTIVE IS 

;NOT EVALUATED. 

.ENDC 
.ENDC 



6.9.3 Immediate Conditional Assembly Directive ' ' 



Format: 

.IIF cond,arg , statement 

where: cond represents one of the legal condition tests 

defined for conditional assembly blocks in Table 
6-6. 

, represents any legal separator (comma, space, 

and/or tab) . 

arg represents the argument associated with the 
immediate conditional directive; an expression, 
symbolic argument, or macro- type argument, as 
described in Table 6-6. 
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where: , represents the separator between the conditional 

argument and the statement field. If the 
preceding argument is an expression, then a comma 
must be used; otherwise, a comma, space, and/or 
tab may be used. 

statement represents the specified statement to be assembled 
if the condition is satisfied. 

An immediate conditional assembly directive provides a means for 
writing a 1-line conditional assembly block. The use of this 
directive requires no terminating .ENDC statement and the condition to 
be tested is completely expressed within the line containinQ the 
directive. 

For example, the immediate conditional statement: 

.IIP DF FOO,BEQ ALPHA 
generates the code 

BEQ ALPHA 

if the symbol FOO is defined within the source program. 

As with the .IF directive, a condition test other than those listed in 
Table 6-6, an illegal argument, or a null argument specified in an 
.IIF directive results in an error code (A) in the assembly listing. 



6.9.4 PAL-llR Conditional Assembly Directives 

In order to maintain compatibility with programs developed under 
PAL-llR, using the following conditionals remains permissible under 
MACRO-11. It is advisable, however, to develop future programs using 
the format for MACRO-11 conditional assembly directives. 

Assemble Block if 

Expression=0 
Expression not equal 
Expression<0 
Expression>0 
Expression is < or =0 
Symbol is defined 
Symbol is undefined 

The rules governing these directives are the same as those for the 
MACRO-11 conditional assembly directives previously described. 



Directive 


Arguments 


.IF2 or 


.IFEQ 


Expression 


.IFNZ or 


.IFNE 


Expression 


.IFL or 


.IFLT 


Expression 


.IFG or 


.IFGT 


Expression 


.IFLE 




Expression 


• IFDF 




Symbolic argument 


.IFNDF 




Symbolic argument 
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CHAPTER 7 
MACRO DIRECTIVES 



7.1 DEFINING MACROS 

By using macros a programmer can use a 
sequence of lines into a source program. 



single line to insert 



A macro definition is headed by a .MACRO directive (see Section 7.1.1) 
followed by the source lines. The source lines may optionally contain 
dummy arguments. If such arguments are used, each one is listed in 
the .MACRO directive. 

A macro call {see Section 7.3) is the statement used by the programmer 
to call the macro into the source program. It consists of the macro 
name followed by the real arguments needed to replace any dummy 
arguments used in the macro. 

Macro expansion is the insertion of the macro source lines into the 
main program. Included in this insertion is the replacement of the 
dummy arguments by the real arguments. 

Macro directives provide the means to manipulate the macro expansions. 
Only one directive is allowed per source line. Each directive may 
have a blank operand field or one or more operands. Legal operands 
differ with each directive. The macros and their associated 
directives are detailed in this chapter. 



7.1.1 .MACRO Directive 

FORMAT : 

[label:] 
where: label 
name 



.MACRO 



.MACRO name, dummy argument list 
represents an optional statement label. 



represents the user-assigned symbolic name of the 
macro. This name may be any legal symbol and may 
be used as a label elsewhere in the program. 

represents any legal separator (comma, space, 

=»r»rl/r\r -J-aH^ 
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where: dummy represents a number of legal symbols (see Section 
argument 3.2.2) that may appear anywhere in the body of the 
list macro definition, even as a label. These dummy 
symbols can be used elsewhere in the program with 
no conflict of definition. Multiple dummy 
arguments specified in this directive may be 
separated by any legal separator. The detection 
of a duplicate or an illegal symbol in a dummy 
argument list terminates the scan and causes an 
error code (A) to be generated. 

A comment may follow the dummy argument list in a .MACRO directive, as 
shown below: 

•MACRO ABS A,B ; DEFINES MACRO ABS WITH TWO ARGUMENTS. 
The first statement of a macro definition must be a .MACRO directive. 



NOTE 



Although it i 
appear on 
practice is d 
the case of 
because inv 
constructed 
character wil 
to be ignor 
improper ter 
definition. 



s legal for a label to 
a .MACRO directive, this 
iscouraged, especially in 
nested macro definitions, 
alid labels or labels 
with the concatenation 
1 cause the macro directive 
ed. This may result in 
mination of the macro 



This NOTE also applies to 
and .REPT. 



, IRP, .IRPC, 



7.1.2 



,ENDM Directive 



ENDM 



FORMAT: 



.ENDM [name] 



where: name represents an optional argument specifying the 

name of the macro being terminated by the 
directive. 



Example: 



,ENDM 



; TERMINATES THE CURRENT 
; MACRO DEFINITION. 



,ENDM 



ABS 



; TERMINATES THE CURRENT 

J MACRO DEFINITION NAMED ABS, 



If specified, the macro name in the .ENDM statement must match the 
name specified in the corresponding .MACRO directive. Otherwise, the 
statement is flagged with an error code (A) in the assembly listing. 
In either case, the current macro definition is terminated. 
Specifying the macro name in the .ENDM statement thus permits MACRO-11 
to detect missing .ENDM statements or improperly nested macro 
definitions. 
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The .ENDM directive must not have a label. If a legal label is 
attached, it will be ignored. If an illegal label is attached, the 
directive will be ignored. 



The .ENDM directive may be followed by a 
below: 



comment field, as shown 



.MACRO TYPMSG MESSGE 

JSR R5, TYPMSG 

.WORD MESSGE 
.ENDM 



;TyPE A MESSAGE, 



;END OF TYPMSG MACRO. 



TVio final cf- a ^-o^n<=^n^- 



Of ever" macro definition must be an ^ENDM 
directive. The .ENDM directive is also used to terminate indefinite 
repeat blocks (see Section 7.6) and may be used to terminate repeat 
blocks (see Section 7.7). 



7.1.3 



,MEXIT Directive 



.MEXIT 



FORMAT : 

.MEXIT 

The .MEXIT directive may be used to terminate a macro expansion before 
the end of the macro is encountered. This directive is also legal 
within repeat blocks (see Sections 7.6 and 7.7). It is most useful in 
nested macros. The .MEXIT directive terminates the current macro as 
though an .ENDM directive had been encountered. Using the .MEXIT 
directive bypasses the complexities of nested conditional directives 
and alternate assembly paths, as shown in the following example: 

.MACRO ALTR N,A,B 



f tJ J.£-l.i.VX 



JLSLJ J. ^ A.\Ji.'tC\J-l X~^l_'l_7 J-IL'1J_)XJ X 1^ i-i\J \^ l.\ t 



.MEXIT 
.ENDC 



; TERMINATE MACRO EXPANSION. 
;BND CONDITIONAL ASSEMBLY BLOCK. 



.ENDM 



f J.1 vi\i-in.i_j jjitu -^ L 



In an assembly where the dummy symbol N is replaced by zero (see Table 
6-6) , the .MEXIT directive would assemble the conditional block and 
terminate the macro expansion. when macros are nested, a .MEXIT 
directive causes an exit to the next higher level of macro expansion. 

A .MEXIT directive encountered outside a macro definition is flagged 
with an error code (0) in the assembly listing. 
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7.1.4 MACRO Definition Formatting 

A form-feed character used within a macro definition causes a page 
eject during the assembly of the macro definition. A page eject, 
however, is not performed when the macro is expanded. 

Conversely, when the .PAGE directive is used in a macro definition, it 
is ignored during the assembly of the macro definition, but a page 
eject is performed when that macro is expanded. 



7.2 CALLING MACROS 

FORMAT : 

[label:] name real arguments 

where: label represents an optional statement label. 

name represents the name of the macro, as specified in 
the .MACRO directive (see Section 7.1.1). 

real represent symbolic arguments which replace 
arguments the dummy arguments listed in the .MACRO 
directive. When multiple arguments occur, they 
are separated by any legal separator. Arguments 
to the macro call are treated as character 
strings, their usage is determined by the macro 
definition. 

A macro definition must be established by means of the .MACRO 
directive (see Section 7.1.1) before the macro can be called and 
expanded within the source program. 

When a macro name is the same as a user label, the appearance of the 
symbol in the operator field designates the symbol as a macro call; 
the appearance of the symbol in the operand field designates it as a 
label, as shown below: 



ABS: 



MOV 



(RO) ,R1 



;ABS IS DEFINED AS A LABEL. 



BR 



ABS 



;ABS IS CONSIDERED TO BE A LABEL. 



ABS 



#4,ENT,LAR 



;ABS IS A MACRO CALL. 



7.3 ARGUMENTS IN MACRO DEFINITIONS AND MACRO CALLS 

Multiple arguments within a macro definition or macro call must be 
separated by one of the legal separating characters described in 
Section 3.1.1. 

Macro definition arguments (dummy) and macro call arguments (real) 
normally maintain a strict positional relationship. That is, the 
first real argument in a macro call corresponds with the first dummy 
argument in a macro definition. Only the use of keyword arguments in 
a macro call can override this correspondence (see Section 7.3.6). 
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For example, the following macro definition and its associated macro 
call contain multiple arguments: 

.MACRO REN A,B,C 



REN ALPHA, BETA, <C1,C2> 

Arguments which themselves contain separating characters must be 
enclosed in paired angle brackets. For example, the macro call: 

REN <MOV X,-Y> ,-#44 fWEV 

causes the entire expression 

MOV X,Y 

to replace all occurrences of the symbol A in the macro definition. 
Real arguments within a macro call are considered to be character 
strings and are treated as a single entity during the macro expansion. 

The up-arrow (") construction allows angle brackets to be passed as 
part of the argument. This construction, for example, could have been 
used in the above macro call, as follows: 

REN "^AMOV X,Y>/,#44,WEV 

causing the entire character string <MOV X,Y> to be passed as an 
argument. 

Because of the use of the up-arrow (") shown above, care must be taken 
when passing an argument beginning with a unary operator ('^0, "d, "^B, 
'^R, '^F ...). These arguments must be enclosed in angle brackets (as 
shown below) or MACRO-11 will read the character following the 
up-arrow as a delimiter. 

REN <"0 411>,X,Y 

The following macro call: 

REN #44,WEV"/MOV X,Y/ 

contains only two arguments (#44 and WEV^/MOV X,Y/) , because the 
up-arrow is a unary operator (see Section 3.1.3) and it is not 
preceded by an argument separator. 

As shown in the examples above, spaces can be used within bracketed 
argument constructions to increase the legibility of such expressions. 



7.3.1 Macro Nesting 

Macro nesting occurs where the expansion of one macro includes a call 
to another. The depth of nesting allowed depends upon the amount of 
dynamic memory used by the source program being assembled. 

To pass an argument containing legal argument delimiters to nested 
macros, enclose the argument in the macro definition within angle 
brackets, as shown in the coding sequence below. This extra set of 
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angle brackets for each level of nesting is required in the macro 
definition, not in the macro call. 

.MACRO LEVELl DUMl,DUM2 

LEVEL2 <DUM1> 

LEVEL2 <DUM2> 
.ENDM 

.MACRO LEVEL2 DUM3 

DUM3 

ADD #10, RO 

MOV R0,(R1)+ 

.ENDM 

A call to the LEVELl macro, as shown below, for example: 

LEVELl <MOV X,R0>,<MOV R2,R0> 

causes the following macro expansion to occur: 

MOV X,RO 

ADD #10, RO 

MOV RO , ( Rl ) + 

MOV R2 , RO 

ADD #10, RO 

MOV R0,(R1)+ 

When macro definitions are nested, the inner definition cannot be 
called until the outer macro has been called and expanded. For 
example, in the following coding: 

.MACRO LVl A,B 



.MACRO LV2 C 



.ENDM 
.ENDM 

the LV2 macro cannot be called and expanded until the LVl macro has 
been expanded. Likewise, any macro defined within the LV2 macro 
definition cannot be called and expanded until LV2 has also been 
expanded. 



7.3.2 Special Characters in Macro Arguments 

If an argument does not contain spaces, tabs, semicolons, or commas it 
may include special characters without enclosing them in a bracketed 
construction. For example: 

.MACRO PUSH ARC 
MOV ARG,-(SP) 
.ENDM 



PUSH X+3(%2) 
causes the following code to be generated: 
MOV X+3 (%2) ,-(SP) 
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7.3.3 Passing Numeric Arguments as Symbols 

If the unary operator backslash (\) precedes an argument, the macro 
treats that argument as a numeric value in the current program radix. 
The ASCII characters representing this value are inserted in the macro 
expansion, and their function is defined in the context of the 
resulting code, as shown in the following example: 



B=B+1 



A'B: 



.MACRO INC A,B 

CON A,\B 

.ENDM 

.MACRO CON AjB 

•WORD 4 

.ENDM 



;B IS TREATED AS A NUMBER IN CURRENT 
; PROGRAM RADIX. 



;A'B IS DESCRIBED IN SECTION 7.3,7. 



C=0 INC X,C 

The above macro call (INC) would thus expand to; 



XO: 



.WORD 



In this expanded code, the label XO: results from the concatenation 
of two real arguments. The single quote (') character in the label 
A'B: concatenates the real arguments X and as they are passed 
during the expansion of the macro. This type of argument construction 
is described in more detail in Section 7.3.7. 

A subseQuent call to the sam.e m.acro would generate the following code: 



XI; 



.WORD 



and so on, for later calls. The two macro definitions are necessary 
because the symbol associated with dummy argument B (that is, C) 
cannot be updated in the CON macro definition, because the character 
has replaced C in the argument string (INC X, C) . In the CON macro 
definition, the number passed is treated as a string argument. (Where 
the value of the real argument is 0, only a single character is 

Passing numeric values in this manner is useful in identifying source 
listings. For example, versions of programs created through 
conditional assemblies of a single source program can be identified 
through such coding as that shown below. Assume, for example, that 
the symbol ID in the macro call (IDT) has been equated elsewhere in 
the source program to the value 6. 



.MACRO IDT SYM 
, IDENT /VOSA'SYM/ 
• ENDM 



; ASSUME THAT THE SYMBOL ID TAKES 
;0N A UNIQUE 2-DIGIT VALUE. 
;WHERE V05A IS THE UPDATE 
; VERS ION OF THE PROGRAM. 



IDT \ID 
The above macro call would then expand to: 

.IDENT /V05A6/ 
where 6 is the numeric value of the symbol ID. 
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7.3.4 Number of Arguments in Macro Calls 

A macro can be defined with or without arguments. If more arguments 
appear in the macro call than in the macro definition, an error code 
(Q) is generated in the assembly listing. If fewer arguments appear 
in the macro call than in the macro definition, missing arguments are 
assumed to be null values. The conditional directives .IF B and 
.IF NB (see Table 6-6) can be used within the macro to detect missing 
arguments. The number of arguments can also be specified using the 
.NARG directive (Section 7.4.1). 



7.3.5 Creating Local Symbols Automatically 

A label is often required in an expanded macro. In the conventional 
macro facilities thus far described, a label must be explicitly 
specified as an argument with each macro call. The user must be 
careful in issuing subsequent calls to the same macro in order to 
avoid duplicating labels. This concern can be eliminated through a 
feature of MACRO-11 that creates a unique symbol where a label is 
required in an expanded macro. 

As noted in Section 3.5, MACRO-11 can automatically create local 
symbols of the form n$ , where n is a decimal integer within the range 
64 through 127, inclusive. Such local symbols are created by MACRO-11 
in numerical order, as shown below: 

64$ 
65$ 



126$ 
127$ 

This automatic generation is invoked on each call of a macro whose 
definition contains a dummy argument preceded by the question mark (?) 
character, as shown in the macro definition below: 

.MACRO ALPHA, A,?B ; CONTAINS DUMMY ARGUMENT B PRECEDED BY 

; QUESTION MARK. 

TST A 

BEQ B 

ADD #5, A 
B: 

.ENDM 

A local symbol is created automatically by MACRO-11 only when a real 
argument of the macro call is either null or missing, as shown in 
Example 1 below. If the real argument is specified in the macro call, 
however, MACRO-11 inhibits the generation of a local symbol and normal 
argument replacement occurs, as shown in Example 2 below. (Examples 1 
and 2 are both expansions of the Alpha macro defined above.) 
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EXAMPLE 1: Create a Local Symbol for the Missing Argument: 

ALPHA Rl ; SECOND ARGUMENT IS MISSING. 

TST Rl 

BEQ 64$ ; LOCAL SYMBOL IS CREATED. 

ADD #5,R1 
64$: 

EXAMPLE 2: DO Not Create a Local Symbol: 

ALPHA R2,XYZ ; SECOND ARGUMENT XYZ IS SPECIFIED. 

TST R2 

BEQ XYZ jNGRMAL ARGUMENT REPLACEMENT OCCURS. 

ADD #5,R2 
XYZ: 

Automatically created local symbols are restricted to the first 16(10) 
arguments of a macro definition. 

Automatically created local symbols resulting from the expansion of a 
macro, as described above, do not establish a local symbol block in 
their own right. 

When a macro has several arguments earmarked for automatic local 
symbol generation, substituting a specific label for one such argument 
risks assembly errors because MACRO-11 constructs its argument 
substitution list at the point of macro invocation. Therefore, the 
appearance of a label, the .ENABL LSB directive, or the .PSECT 
directive, in the macro expansion will create a new local symbol 
block. The new local symbol block could leave local symbol references 
in the previous block and their symbol definitions in the new one, 
causing error codes in the assembly listing (see Appendix D) . 
Furthermore, a later macro expansion that creates local symbols in the 
new block may duplicate one of the symbols in question, causing an 
additional error code (P) in the assembly listing. 



7.3.6 Keyword Arguments 

FORMAT : 

name=str ing 

where: name represents the dummy argument, 

string represents the real symbolic argument. 

The keyword argument may not contain embedded argument separators 
unless delimited as described in section 7.3. 

Macros may be defined with, and/or called with, keyword arguments. 
When a keyword argument appears in the dummy argument list of a macro 
definition, the specified string becomes the default real argument at 
macro call. When a keyword argument appears in the real argument list 
of a macro call, however, the specified string becomes the real 
argument for the dummy argument that matches the specified name, 
whether or not the dummy argument was defined with a keyword. If a 
match fails, the entire argument specification is treated as the next 
positional real argument. 
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A keyword argument may be specified anywhere in the dummy argument 
list of a macro definition and is part of the positional ordering of 
argument. A keyword argument may also be specified anywhere in the 
real argument list of a macro call but, in this case, does not affect 
the positional ordering of the arguments. 

.LIST ME 

DEFINE A MACRO HAVING KEYWORDS IN DUMMY ARGUMENT LIST 

.MACRO TEST C0NTRL=1 , BLOCK ,ADDRES=TEMP 

.WORD CONTRL 

. WORD BLOCK 

.WORD ADD RES 

.ENDM 



NOW INVOKE SEVERAL TIMES 



1 






2 






3 






4 






5 






6 






7 






8 






9 






10 






11 






12 






13 






14 






15 






16 






17 


000000 






000000 


OOOOOOG 




000002 


OOOOOOG 




000004 


OOOOOOG 


18 






19 


000006 






000006 


000040 




000010 


000030 




000012 


000020 


20 






21 


000014 






000014 


000001 




000016 


000005 




000020 


OOOOOOG 


22 






23 


000022 






000022 


000005 




000024 


000000 




000026 


OOOOOOG 


24 






25 


000030 






000030 


000001 




000032 


000000 




000034 


OOOOOOG 


26 






27 


000036 






000036 


000001 




000040 


000000 




000042 


ooooooc 


28 






29 






30 




000001 



TEST 
.WORD 
.WORD 
.WORD 


A,B,C 

A 

B 

C 


TEST 
.WORD 
.WORD 
.WORD 


ADDRES=20 ,BLOCK=30 ,CONTRL=40 

40 

30 

20 


TEST 
.WORD 
.WORD 
.WORD 


BL0CK=5 

1 
5 
TEMP 


TEST 
.WORD 
.WORD 
.WORD 


C0NTRL=5 ,ADDRES=VARIAB 
5 

VARIAB 


TEST 
.WORD 
.WORD 
.WORD 


1 
TEMP 


TEST 
.WORD 
.WORD 
.WORD 


ADDRES=JACK!JILL 

1 

JACKIJILL 



.END 
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7.3.7 Concatenation of Macro Arguments 

The apostrophe or single quote character (') operates as a legal 
delimiting character in macro definitions. A single quote that 
precedes and/or follows a dummy argument in a macro definition is 
removed, and the substitution of the real argument occurs at that 
point. For example, in the following statements; 

.MACRO DEF A,B,C 

A'B: .ASCIZ /C/ 

.BYTE ' 'A, ' 'B 
.ENDM 

when the macro DEF is called through the statement: 

DEF X,Y,<MACR0-11> 

it is expanded, as follows: 

XY: .ASCIZ /MACRO-11/ 
. BYTE ' X , ' Y 

In expanding the first line, the scan for the first argument 
terminates upon finding the first apostrophe (') character. Since A 
is a dummy argument, the apostrophe (') is removed. The scan then 
resumes with B; B is also noted as another dummy argument. The two 
real arguments X and Y are then concatenated to form the label XY:. 
The third dummy argument is noted in the operand field of the .ASCIZ 
directive, causing the real argument MACRO-11 to be substituted in 
this field. 

When evaluating the arguments of the .BYTE directive during expansion 
of the second line, the scan begins with the first apostrophe (') 
character. Since it is neither preceded nor followed by a dummy 
argument, this apostrophe remains in the macro expansion. The scan 
then encounters the second apostrophe, which is followed by a dummy 
argument and is therefore discarded. The scan of argument A is 
terminated upon encountering the comma (,). The third apostrophe is 
neither preceded nor followed by a dummy argument and again remains in 
the macro expansion. The fourth (and last) apostrophe is followed by 
another dum.m." argum.ent and is likewise discarded. (Four apostrophe 
(') characters were necessary in the macro definition to generate two 
apostrophe (') characters in the macro expansion.) 



7.4 MACRO ATTRIBUTE DIRECTIVES: .NARG, .NCHR, AND .NTYPE 

MACRO-11 has three directives that allow the user to determine certain 
attributes of macro arguments: .NARG, .NCHR,- and .NTYPE. The use of 
these directives permits selective modifications of a macro expansion, 
depending on the nature of the arguments being passed. These 
directives are described below. 
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NARG 



7.4.1 .NARG Directive 

FORMAT : 

[label:] .NARG symbol 

where: label represents an optional statement label. 

symbol represents any legal symbol. This symbol is 
equated to the number of arguments in the macro 
call currently being expanded. If a symbol is not 
specified, the .NARG directive is flagged with an 
error code (A) in the assembly listing. 

The .NARG directive is used to determine the number of arguments in 
the macro call currently being expanded. Hence, the .NARG directive 
can appear only within a macro definition; if it appears elsewhere, 
an error code (0) is generated in the assembly listing. 

An example of the .NARG directive is shown in Figure 7-1. 



1 






.TITLE 


NARG 


2 










3 






.ENABL 


LC 


4 






.LIST 


ME 


5 




( + 






6 




r ExsikP 


le of th 


e .NARG directive 


7 




f - 






8 










9 




.MACRO 


NULL 


NUM 


10 






.NARG 


SYM 


11 






.IF EQ 


SYM 


12 






.MEXIT 




13 






.IFF 




14 






.REPT 


NUM 


>15 






NOP 




U 






.ENDM 




17 






.ENDC 




18 




.ENDM 






19 










20 000000 






NULL 






000000 




.NARG 

.IF EQ 

.MEXIT 

.IFF 

.REPT 

NOP 

.ENDM 

.ENDC 


SYM 
SYM 


21 










22 000000 






NULL 


6 




000001 




.NARG 
.IF EQ 
.MEXIT 
.IFF 


SYM 
SYM 




000006 




.REPT 

NOP 

.ENDM 


6 


000000 


000240 




NOP 




000002 


000240 




NOP 




000004 


000240 




NOP 




000006 


000240 




NOP 




000010 


000240 




NOP 




000012 


000240 




NOP 
.ENDC 




23 










24 


000001 




.END 
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7.4,2 .NCHR Directive 



.NCHR 



FORMAT : 

[label:] 
where: label 



•NCHR symbol, <string> 

represents an optional statement label. 

^tTmK*-»i r£hr\T dear,*- c an^'" lo'^al s^'mbol ■ This s'^'mbol is 
equated to the number of characters in the 
specified character string. If a symbol is not 
specified, the .NCHR directive is flagged with an 
error code (A) in the assembly listing. 

, represents any legal separator (comma, space, 
and/or tab) . 

<string> represents a string of printable characters. If 
the character string contains a legal separator 
(comma, space, and/or tab) the whole string must 
be enclosed within angle brackets (<>) or 
up-arrows C^) . If the delimiting characters do 
not match or if the ending delimiter cannot be 
detected because of a syntactical error in the 
character string (thus prematurely terminating its 
evaluation) , the .NCHR directive is flagged with 

an ar r- r\r rrtri a t 7i\ in i-Vio accomHl^? 1lQ+-ino* 

The .NCHR directive, which can appear anywhere in a MACRO-11 program, 
is used to determine the number of characters in a specified character 
string. This directive is useful in calculating the length of macro 
arguments. 

An example of the .NCHR directive is shown in Figure 7-2. 



1 








.TITLE 


NCHR 


2 












3 








.ENABL 


LC 


4 








.LIST 


ME 


5 






J + 






6 






i Illus 


trate th 


e .NCHR dir 


7 






J - 






B 












9 






.MACRO 


STRING 


MESSAG 


10 








.NCHR 


$»$rMESSAG 


U 








.WORD 


i%* 


12 








.ASCII 


/MESSAG/ 


13 








.EVEN 




14 






• ENDM 






15 












16 


000000 




MSGl! 


STRING 


<Hello> 






000005 




.NCHR 


«t$iHella 




000000 


000005 




.WORD 


««» 




000002 


110 




.ASCII 


/Hello/ 




000003 


145 










000004 


154 










000005 


154 










000006 


157 




.EVEN 




17 












IS 




000001 




.END 





Figure 7-2 Example of .NCHR Directive 
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7.4.3 .NTYPE Directive 

FORMAT : 

[label:] 
where: label 
symbol 



.NTYPE 



NTYPE symbol, aexp 
represents an optional statement label. 



represents any legal symbol. This symbol is 
equated to the 5-bit addressing mode of the 
following expression (aexp) . If a symbol is not 
specified, the .NTYPE directive is flagged with an 
error code (A) in the assembly listing. 

, represents any legal separator (comma, space, 
and/or tab) . 

aexp represents any legal address expression, as used 
with an opcode. If no argument is specified, an 
error code (A) will appear in the assembly 
listing. 

The .NTYPE directive is used to determine the addressing mode of a 
specified macro argument. Hence, the .NTYPE directive can appear only 
within a macro definition; if it appears elsewhere, it is flagged 
with an error code (0) in the assembly listing. 



An example of the use of an .NTYPE directive in a macro definition 
shown in Figure 7-3. 



is 



1 








.TITLE 


NTYPE 


2 












3 








.ENABL 


LC 


4 








.LIST 


HE 


5 












6 






i + 






7 






f Illustrate th 


e .NTYPE dir 


8 






1 - 






9 












10 






.MACRO 


SAVE 


ARG 


11 








•NTYPE 


tt«>ARG 


12 






.IF EO 


t»«S70 




13 








MOV 


ARGf-<SP) 


14 








.IFF 




15 








MOV 


»ARG,-(SP) 


16 






• ENCC 






17 






.ENDM 






18 












19 


000000 






SAVE 


Rl 






000001 


.IF ECl 


.NTYPE 
$$*t70 


♦$*iRl 




000000 


010146 


.ENDC 


MOV 

.IFF 

MOV 


R1,-(SP) 
*R1,-(SP) 


20 












21 


000002 






SAVE 


TEMP 






000067 


.IF EQ 


.NTYPE 
««$S70 
MOV 
.IFF 


*»$.TEMP 
TEMP.-(SP) 




000002 


012746 
000006' 


.FNDC 


MOV 


»TEMP,-(SP) 


22 












23 


000006 


000000 


TEMPt 


.UORD 





24 












25 




000001 




• END 





iSsve in register mo6e 
iSsve in non-reaister kode 



iSsve in rei^ister Kode 
rSave in non-reaister node 



>S3ve in register hode 
fSsve in non-reaister node 



Figure 7-3 Example of .NTYPE Directive in Macro Definition 
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For additional information concerning addressing modes, refer to 
Chapter 5 and Appendix B.2. 



7,5 .ERROR AND .PRINT DIRECTIVES 

FORMAT : 



.ERROR 



r 1 =.K*^i . 1 






where: 



label 

expr 



text 



represents an optional statement label. 

represents an optional expression whose value is 
output when the .ERROR directive is encountered 
during assembly. 

denotes the beginning of the text string. 

represents the message associated with the .ERROR 
directive. 



The .ERROR directive is used to output messages to the listing file 
during assembly pass 2. A common use of this directive is to alert 
the user to a rejected or erroneous macro call or to the existence of 
an illegal set of conditions in a conditional assembly. If the 
listing file is not specified, the .ERROR messages are output to the 

/"* /"Wnvn ^ Y> f^ ^'\ ^ t ■^ -r^ yt ^ i^ ^r-r ■i /-^ r\ 

Upon encountering an .ERROR directive anywhere in a source program, 
MACRO-11 outputs a single line containing: 

1. An error code (P) 

2. The sequence number of the .ERROR directive statement 

3. The value of the current location counter 

4. The value of the expression, if one is specified 

5. The source line containing the .ERROR directive. 
For example, the following directive: 

.ERROR A ; INVALID MACRO ARGUMENT 

the following form to be output to the listing file: 



Seq. Loc. 
No. No. 



Exp. 
Value 



512 005642 000076 



, ERROR 



Text 
; INVALID MACRO ARGUMENT 



.PRINT 



The .PRINT directive is identical in function to the .ERROR directive, 
except that it is not flagged with the P error code. 
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7.6 INDEFINITE REPEAT BLOCK DIRECTIVES: .IRP AND . IRPC 

An indefinite repeat block is similar to a macro definition with only 
one dummy argument. At each expansion of the indefinite repeat range, 
this dummy argument is replaced with successive elements of a real 
argument list. Since the repeat directive and its associated range 
are coded in-line within the source program, this type of macro 
definition and expansion does not require calling the macro by name, 
as required in the expansion of the conventional macros previously 
described in this chapter. 

An indefinite repeat block can appear either within or outside another 
macro definition, indefinite repeat block, or repeat block. The rules 
for specifying indefinite repeat block arguments are the same as for 
specifying macro arguments (see Section 7.3). 



.IRP 



7.6.1 .IRP Directive 
FORMAT : 

[label:] .IRP sym,<argument list> 

(range of indefinite repeat block) 

,ENDM 
where: label represents an optional statement label. 

NOTE 

Although it is legal for a label to appear 
on a .MACRO directive, this practice is 
discouraged, especially in the case of 
nested macro definitions, because invalid 
labels or labels constructed with the 
concatenation character will cause the 
macro directive to be ignored. This may 
result in improper termination of the 
macro definition. 

This NOTE also applies to .IRPC and .REPT. 

sym represents a dummy argument that is replaced with 
successive real arguments from within the angle 
brackets. If no dummy argument is specified, the 
.IRP directive is flagged with an error code (A) 
in the assembly listing. 

, represents any legal separator (comma, space, 
and/or tab) . 
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<argument list> represents a list of real arguments enclosed 

within angle brackets that is to be used in the 
expansion of the indefinite repeat range. A real 
argument may consist of one or more characters; 
multiple arguments must be separated by any legal 
separator (comma, space, and/or tab) . If no real 
arguments are specified, no action is taken. 

range represents the block of code to be repeated once 
for each occurrence of a real argument in the 
list. The range may contain other macro 
definitions, repeat ranges and/or the .MEXIT 
directive ^see *^ection 7 "* ^^ 

•ENDH indicates the end of the indefinite repeat block 
range. 

The .IRP directive is used to replace a dummy argument with successive 
real arguments specified in an argument string. This replacement 
process occurs during the expansion of an indefinite repeat block 
range. 

An example of the use of the .IRP directive is shown in Figure 7-4. 



.IRPC 



7.6.2 .IRPC Directive 
FORMAT : 

[label:] .IRPC sym,<string> 

(range of indefinite repeat block) 



.ENDM 

where: label represents an optional statement label (see Note 

in Section 7.6.1) . 

sym represents a dummy argument that is replaced with 
successive real arguments from within the angle 
brackets. If no dummy argument is specified, the 
.IRPC directive is flagged with an error code (A) 
in the assembly listing. 

, represents any legal separator (comma, space, 
and/or tab) . 

<string> represents a list of characters, enclosed within 
angle brackets, to be used in the expansion of the 
indefinite repeat range. Although the angle 
brackets are required only when the string 
contains separating characters, their use is 
recommended for legibility. 
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represents the block of code to be repeated once 
for each occurrence of a character in the list. 
The range may contain macro definitions, repeat 
ranges and/or the .MEXIT directive (see Section 
7.1.3) . 



,ENDM 



indicates the end of the indefinite 
range. 



repeat block 



The .IRPC directive is available to permit single character 
substitution, rather than argument substitution. On each iteration of 
the indefinite repeat range, the dummy argument is replaced with 
successive characters in the specified string. 

An example of the use of the .IRPC directive is shown in Figure 7-4. 

1 .TITLE IRPTST 



3 
A 




ft 


.LIST 


ME 


5 




! Ill 


ustrste th 


e .IRP and .IRPC directives 


6 

7 




} ba 


cresting s 


psir of RADSO tables 


8 

9 000000 




REGS: 


.IRP 


REe.<PC.SP.R5FR4FR3.R2FRl»R0> 


10 






.RAD50 


/REG/ 


11 






.ENDR 




000000 


062170 




.RADSO 


/PC/ 


000002 


074500 




.RAI350 


/SP/ 


000004 


072770 




. RADSO 


/R5/ 


000006 


072720 




,RAB50 


/R4/ 


000010 


072650 




.RAD50 


/R3/ 


000012 


072600 




. RADSO 


/R2/ 


000014 


072530 




.RAD50 


/Rl/ 


000016 


072460 




.RADSO 


/RO/ 


12 

13 000020 




REGS2 


! .IRPC 


NUHf<76S43210> 


14 






.RADSO 


/R'NUM/ 


15 






.ENDR 




000020 


073110 




. RADSO 


/R7/ 


000022 


073040 




•RADSO 


/R6/ 


000024 


072770 




.RADSO 


/R5/ 


000026 


072720 




. RADSO 


/R4/ 


000030 


072650 




.RADSO 


/R3/ 


000032 


072600 




. RADSO 


/R2/ 


000034 


072530 




.RADSO 


/Rl/ 


000036 


072460 




.RADSO 


/RO/ 


16 










17 


000001 




.END 





Figure 7-4 Example of .IRP and .IRPC Directives 



.REPT 



7.7 REPEAT BLOCK DIRECTIVE: .REPT, .ENDR 

FORMAT : 

[label:] .REPT exp 



ENDR 



[range of repeat block) 



,ENDR 
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where: 



label 



exp 



range 



.ENDM 

or 
.ENDR 



represents an optional statement label (see Note 
in Section 7.6.1) . 

represents any legal expression. This value 
controls the number of times the block of code is 
to be assembled within the program. When the 
expression value is less than or equal to zero 
(0) , the repeat block is not assembled. If this 
expression is not an absolute value, the .REPT 
statement is flagged with an error code (A) in the 
assembly listing. 

represents the block of code to be repeated. The 
repeat block may contain macro definitions, 
indefinite repeat blocks, other repeat blocks 
and/or the .MEXIT directive (see Section 7.1.3). 

indicates the end of the repeat block range. 



The .KEPT directive is used to duplicate a block of code, 
number of times, in line with other source code. 



certain 



7.8 MACRO LIBRARY DIRECTIVE: 



. MCALL 



.MCALL 



FORMAT ! 



where; 



.MCALL argl,arg2, . . .argn 

argl, represent the symbolic names of the macro 
arg2,... definitions required in the assembly of the source 
argn program. The names must be separated by any legal 
separator (comma, space, and/or tab). 

The .MCALL directive allows you to indicate in advance those system 
and/or user-defined macro definitions that are not defined within the 
source program but which are required to assemble the program. The 
.MCALL directive must appear before the first occurrence of a call to 
any externally defined macro. 

The /ML switch (see Section 8.1.3) under RSX-llM and the /LIBRARY 
qualifier (see Section 8.2.2) under IAS and RT-11 , used with an input 
file specification, indicate to MACRO-11 that the file is a macro 
library. When a macro call is encountered in the source program, 
MACRO-11 first searches the user macro library for the named macro 
definitions, and, if necessary, continues the search with the system 
macro library. 

Any number of such user-supplied macro files may be designated. For 
multiple library files, the search for the named macros begins with 
the last such file specified. The files are searched in reverse order 

necessary, with a search of the system macro library. 
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If any named macro is not found upon completion of the search, the 
•MCALL statement is flagged with an error code (U) in the assembly 
listing. Furthermore, a statement elsewhere in the source program 
that attempts to expand such an undefined macro is flagged with an 
error code (0) in the assembly listing. 

The command strings to MACRO-11, through which file specifications are 
supplied, are described in detail in the applicable system manual (see 
Section 0.3 in the Preface). 
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PART IV 
OPERATING PROCEDURES 



CHAPTER 8 
lAS/RSX-llM/RSX-llM-PLUS OPERATING PROCEDURES 



8.1 RSX-llM OPERATING PROCEDURES 

The following sections describe MACRO-11 operating procedures that 
apply only to the RSX-llM system. 



8.1,1 Initiating MACRO-11 Under RSX-llM/RSX-llM-PLUS 

Following the entry of CTRL/C ("O from an operator's console, the 
Monitor Console Routine (MCR) indicates its readiness to accept a 
command by prompting with: 

MCR> 

In response, any one of the five methods described below may be 
employed to initiate MACRO-11. 



8.1.1.1 Method 1 - Direct MACRO-11 Call 

FORMAT : 

MCR>MAC 
MAC>macll-cmd-string 

The monitor console routine (MCR) accepts MAC as input, causing 
MACRO-11 to be activated. Since an assembly command string is not 
present with the MCR line, MACRO-11 then solicits input with the 
prompting sequence MAO and waits for command string input. The 
command string input, macll-cmd-str ing, is any legal, syntactically 
correct MACRO-11 command string of the form described in Section 
8.1.2. After the assembly of the indicated files has been completed, 
MACRO-11 again solicits command string input with the MAO prompting 
sequence. This process is repeated until a CTRL/Z ("z) is entered. 



8.1.1.2 Method 2 - Using RUN Facility 
FORMAT : 

MCR>RuN . . .MAC[/uIC=ig,m] ] 
MAO macll-cmd-str ing 
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Method 2 is identical to method 1 except for the use of the MCR RUN 
command which requires the entire task name, including the 3-dot 
prefix. When the optional /UIC is used, the default User 
Identification Code (UIC) is changed for one execution. As in method 
1, MACRO-11 solicits command string input (see Section 8.1.2) after 
the assembly of the indicated files is completed. 



8.1.1.3 Method 3 - Single Assembly 

FORMAT: 

MCR>MAC macll-cmd- string 

In method 3, because the command string input is included in the MCR 
command line, no prompting is necessary, and MACRO-11 exits after 
assembling the indicated files. 



8.1.1.4 Method 4 - Install, Run Immediately, and Remove On Exit 

FORMAT : 

MCR>RUN $MAC[/UIC=[g,m]] 
MAOmacll-cmd-string 

Method 4 is used when the MACRO-11 assembler is not permanently 
installed in the system. The Monitor Console Routine (MCR) installs 
MAC from the system program directory and requests it under the 
specified User Identification Code (UIC). As in methods 1 and 2, 
MACRO-11 solicits command string input (see Section 8.1.2). After 
exiting, MACRO-11 is automatically removed from the system. 



NOTE 

MACRO-11 can be terminated by entering a 
CTRL/Z ("z) at any time a request for 
command string input is present. 



8.1.1.5 Method 5 - Using Indirect Filename Facility 

FORMATS : 

MCR>MAC 
MAC>@filespec 

or 

MCR>RUN . ..MAC[/UIC=[g,m]] 
MAOifilespec 

or 

MCR>MAC @filespec 

or 

MAORUN $MAC[/UIC=[g,m]] 
MAC>@filespec 
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These forms use the indirect file facility of RSX-llM, substitutes 
"@fiiespec" for the "macll-cmd-str ing" input used in methods 1 through 
4. The file specified as "@filespec" contains MACRO-11 command 
strings. After this file is opened, command lines are read from the 
file until the end-of-file is detected. Only three nested levels of 
indirect files are permitted in MACRO-11. 



8.1.2 RSX-llM Command String 

FORMAT : 

MAC>object,listing=srcl ,src2, . . . ,srcn 

where: object represents the binary object (output) file. 

listing represents the assembly listing (output) file 
containing the table of contents, the assembly 
listing, and the symbol table. 

separates output file specifications from input 
file specifications. 

srcl, represent the ASCII source (input) files 
src2,... containing the MACRO-11 source program or the 
srcn user-supplied macro library files to be assembled. 

Only two output file specifications in the command string* will be 
recognized by MACRO-11; any more than two such files will be ignored. 
No limit is set on the number of source input files. A.. , cojnmaiid , l^i^ne 
must not be more than ,132 . characters long? however, a Kyph«n 
terminating the line allows ' the , coiranand to be continued on the 
following line. (An 3K assembler allows 80 characters per line and no 
continuation lines.) 

A null specification in either of the output file specification fields 
signifies that the associated output file is not desired. A null 
specification in the input file field, however, is an error condition, 
resulting in the error message "MAC — ILLEGAL FILENAME" on the 
command output device (see Section 8.6). The absence of both the 
device name (dev:) and the name of the file (filename. type) from a 
file specification is the equivalent of a null specification. 

NOTE 

When no listing file is specified, any 
errors encountered in the source program 
are printed on the terminal from which 
MACRO-11 was initiated. When the /NL 
switch is used in the listing file 
specification without an argument, the 
errors and symbol table are output to 
the specified listing file. 
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Each file specification contains the following information (in 
accordance with the standard RSX-llM conventions for file 
specifications) : 

filespec /switch:value ... 

where: filespec. is the standard RSX-llM file specification as 

described in Section 8.5. 

/switch represents an ASCII name identifying a switch 
option. A switch option may be specified in three 
forms, as shown below, depending on the function 
desired: 

/SW Invokes the specified switch action. 
/NOSW Negates the specified switch action. 
/-SW Also negates the specified switch 
action. 

:value . . . 

represents any number of the following values: 
ASCII character strings, octal numbers, or decimal 
numbers. The default assumption for a numeric 
value is octal. Decimal values must be followed 
by a decimal point (.). 

Any numeric value preceded by a number sign (#) is 
regarded as an explicit octal declaration; this 
option is provided for documentation purposes and 
ready identification of octal values. 

Also, any numeric value can be preceded by a plus 
sign (+) or a minus (-) sign. The positive 
specification is the default assumption. If an 
explicit octal declaration is specified (#) , the 
sign indicator, if included, must precede the 
number sign. 

Switch values must always be preceded by a colon 
(:). 

The switch specifications are interpreted in the 
context of the program to which they apply. The 
MACRO-11 switch options are described in Table 
8-2. 

A syntactical error detected in the command string causes MACRO-11 to 
output the following error message to the command output device (see 
Section 8.6): 

MAC — COMMAND SYNTAX ERROR 

followed by a copy of the entire command string. 

Table 8-1 lists the default values for each file specification. 
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Table 8-1 
File Specification Default Values 



File 


Device 


Default 


Value 




Directory 


Filename 


Type 


Object 
File 


System 
device. 


Current 


None 


.OBJ 


Listing 
File 


Device used 
for object 
file. 


Directory 
used in 
object file 


None 


.LST 


Source 1 
File 


System 
device. 


Current 


None 


.MAC 


Source 2 

to 
Source n 
File 


Device used 
for source 1 or 
last source file 
specified. 


Directory 
used for 
source 1 or 
last source 
file speci- 
fied. 


None 


.MAC 


User 

Macro 

Library 


System device, 
if macro file 
is specified 
first; if not, 
device used 
by last source 
file is used. 


Current if 
macro file 
is specified 
first; if not, 
directory of 
last source 
file is used. 


None 


.MLB 


System. 

Macro 

Library 


System 
device. 


[1,1] 


RSXMAC 


.SML 


Indirect 

Command 

File 


System 
device. 


Current 


None 


.CMD 



8.1.3 RSX-llM File Specification Switches 

At assembly time, you may want to override certain MACRO-11 directives 
appearing in the source program, or you may want to direct how certain 
individual files are to be handled during assembly. You can do either 
of these by using switch options with each file (see Section 8.1.2). 
The available switches for use in MACRO-11 file specifications under 
RSX-llM are listed in Table 8-2. 
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Table 8-2 
MACRO-11 File Specification Switches for RSX-llM 



Switch 



/LI : arg 
/NLrarg 



/EN: arg 
/DS:arg 



/ML (see Note) 



Function 



Listing c 
options ace 
(arg) that 
and name to 
and .NLIST d 
source progr 
This switch 
the directiv 
for the enti 



ontrol switches; these 
ept ASCII switch values 
are equivalent in function 
the arguments of the .LIST 
irectives specified in the 
am (see Section 6.1.1). 
overrides the arguments of 
es and remains in effect 
re assembly process. 



Function control switches; these 
options accept ASCII switch values 
(arg) that are equivalent in function 
and name to the arguments of the 
.ENABL and .DSABL directives specified 
in the source program (see Section 
6.2), This switch overrides the 
arguments of the directives and 
remains in effect for the entire 
assembly process. 

The /ML switch, which takes no 
accompanying switch values, indicates 
to MACRO-11 that an input file is a 
macro library file. 



Library files hold the defin 
externally defined macros. 
in Section 7.8, an externall 
macro must be identified in 
directive before it can be 
and assembled with the use 
When MACRO-11 encounters 
directive, a search begin 
definitions of the macros li 



itions of 
As noted 

y defined 
an .MCALL 
retrieved 

r program. 

an .MCALL 

s for the 

sted. 



The search order i 
a macro might 
definitions, in li 
LIB2. If you need 
example, in LIBl, 
LIBl after LIB2 
because MACRO-11 
file specified i 
first, then moves 
the files given 
searched. 



s important because 
have two different 
brary files LIBl and 

the definition, for 
then you must place 
in the command line, 

searches the last 

n the command line 

backwards through 

until all have been 



If a macro's definition is not found 
in any of the files named by the user, 
MACRO-11 automatically searches the 
system macro library; if the 
definition is still not found an error 
code (U) is generated in the assembly 
listing. 



(continued on next paqe) 
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Table 8-2 (Cont.) 
MACRO-11 File Specification Switches for RSX-llM 



Switch 


Function 


/PA:1 (see Note) 


Assemble the associated 
assembly pass 1 only. 


file during 


/PA: 2 (see Note) 


Assemble the associated 
assembly pass 2 only. 


file during 


/SP (see Note) 


Spool listing output (def 


ault value) . 


/NOSP 


Do not spool output. 




/CR: [arg] 


Produce a cross-rGterence listing. 




See Section 8.4. 


■ j 



NOTE 

The /ML, /PA and /SP switches do not 
interact with or override MACRO-11 
directives. Rather, they have meaning 
only in the command line itself. 



Switches for the object file are limited to /EN and /DS; when 
specified, they apply throughout the entire command string. Switch 
options for the listing file are limited to /LI, /NL , /SP , /CR, and 
/NOSP. Switches for input files are limited to /ML, /PA, /EN, and 
/DS; the options /ML and /PA apply only to the file immediately 
preceding the option, whereas the /EN and /DS options, as noted above, 
are applicable to all the files in the command string. 

When using switches with a file specification, be careful not to use 
the same switch more than once, because the values accompanying the 
latest use of the switch will override the values accompanying any 
earlier uses of that switch. For example, in the following command 
string element: 

/LI: SRC/LI :MEB 

the Switch specification /li:HEB will override the previous /LI 



switch, /LI:SRC. If both switch 
specified in the form shown below: 



values are desired, they can be 



/LI:SRC:MEB 



Examples: 



1 . MAOOBJFIL , LSTFIL/NL : BEX : COM/LI : ME=SRCFIL 

This command string suppresses the listing of binary 
extensions and the source comments and lists the macro 
expansions. Furthermore, it causes all listing directives in 

i-iio o\-'Ui-V'C; Jul i. ^^^J L dill iicivj.11^ uii^ u j- ^ uiu^ii u is Oi-i^^, ^-^x^ii , CLki^ tlu v,\^ 

be overridden. In this example, the object output is sent to 
the file named OBJFIL.OBJ, and the listing and symbol table 
output is sent to the file named LSTFIL.LST. 



8-7 



lAS/RSX-llM/RSX-llM-PLOS OPERATING PROCEDDRES 



2. MAC>OBJFIL,LISTM/NL:TOC=SRCFIL 

This command string suppresses the assembly listing's table 
of contents. When the /NL switch is present in the file 
specification without an argument (general no-list mode) all 
listing output except the symbol table is suppressed. 



8.2 OPERATING PROCEDURES APPLICABLE ONLY TO THE RSX-llM-PLUS SYSTEM 



8.2.1 Initiating MACRO-11 Under RSX-llM-PLUS 

RSX-llM-PLUS indicates its readiness to accept a command by prompting 
with: 

DCL> 

In response to this prompt the command strings below may be entered. 

DCL> MACRO [qualifiers] 

FILE? filespec [qualifiers] [ ,filespec,f ilespec. .. ] 

or 

DCL> MACRO [qualifiers] filespec [qualifiers] [ ,f ilespec , filespec. . . ] 

where: qualifiers are commands that affect either the entire 

command string (command qualifiers) or only 
the filespec (parameter qualifiers) . Command 
qualifiers are those that follow the MACRO 
command and parameter qualifiers are those 
that follow the filespec. For a description 
of the command and parameter qualifiers see 
Tables 8-3 and 8-4 respectively. 

filespec is the standard file specification given in 
Section 8.5. (The default file 
specifications are given in Table 8-1.) 



Table 8-3 
RSX-llM-PLUS Command Qualifiers 



Qua 


ilif ier 


Function 


/LIST [: 


filespec] 


Produces an assembly listing file 
according to filespec (see Section 8.5). 
If filespec is not specified, the listing 
has the file name of the last source file 
and the file type .LST. This file is put 
in your User File Directory and also 
printed on the line printer. The default 
is /NOLIST. 


/NOLI ST 


[ : filespec] 


Suppresses an assembly listing of filespec 
(see Section 8.5). This is the default 
condition. 



(continued on next page) 
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Table 8-3 (Cont.) 
RSX-llM-PLUS Command Qualifiers 



Qualifier 



Function 



/OBJECT [:filespec] 



/NOOBJECT 



/CROSS REFERENCE 



/NOCROSS REFERENCE 



/SWITCHES : (/swl : arl : ar2 
. . ./sw4 :arn) 



Produces an object file according to 
filespec (see Section 8.5). If filespec 
is not specified, the object file has the 
file name of the last source file and the 
file type .OBJ. The default is /OBJECT. 

Suppresses the generation of an object 
file. 

Generates a cross-reference listing (see 
Section 8.4). When this qualifier is used 
/LIST is specified by implication. If you 
wish to specify a filespec for the /LIST 
qualifier you must append /LIST: filespec. 

Suppresses the cross-reference listing. 
This is the default condition. 

Overrides the .LIST, .NLIST,ENABL and 
.DSABL directives included in the source 

program. There are four switches 
{swl...sw4) that can be used with 

/SWITCHES: 





Switch 


Function 




/LI:ar 


These are the listing control 




/NLsar 


switches? they accept the 
ASCII switch values (ar) which 
are equivalent in name and 
function to the arguments of 
the .LIST and .NLIST directives 
(see Section 5.1=1). 




/EN:ar 


These are the function control 




/DS:ar 


switches; they accept the 
ASCII switch values (ar) which 
are equivalent in name and 
function to the arguments of 
the .ENABL and .DSABL 
directives (see Section 6.2). 
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Table 8-4 
RSX-llM-PLUS Parameter Qualifiers 



Qualifier 



Function 



/PASS:1 
/PASS: 2 
/LIBRARY 



Assembles the associated 
assembly pass 1 only. 

Assembles the associated 
assembly pass 2 only. 



file during 



file during 



Specifies that an 
library file, 
definitions of ex 
As noted in Se 
defined macro mus 
.MCALL directiv 
retrieved and a 
program. When 
.MCALL directive, 
definitions of th 



input fi 
Library 
ternally 
ction 7. 
t be id 
e befor 
ssembled 
MACRO-11 
a search 
e macros 



le is a macro 
files hold the 
defined macros. 
8, an externally 
entified in an 
e it can be 

with the user 
encounters an 

begins for the 
listed. 



The search order is important because a 
macro might have two different 
definitions, in library files LIBl and 
LIB2. If you need the definition, for 
example, in LIBl, then you must place LIBl 
after LIB2 in the command line, because 
MACRO-11 searches the last file specified 
in the command line first, then moves 
backwards through the files given until 
all have been searched. 

If a macro's definition is not found in 
any of the files named by the user, 
MACRO-11 automatically searches the system 
macro library; if the definition is still 
not found, an error code (U) is generated 
in the assembly listing. 



8.2.2 RSX-llM-PLUS Command String Examples 

1 . >MACRO 

FILE? FILENAM 

or 

>MACRO PILNAM 

Both of these examples assembles the source file FILENAM. MAC 
into a relocatable object module named PILNAM. OBJ. 

2. >MACRO/OBJECT: TESTA PILNAM 

This example produces an object file with the name TESTA. OBJ. 

3. >MACRO FILNAM/LIBRARY, TESTA, SPAN3, SHELL 

Assembles a (concatenated) object file named SHELL. OBJ from 
the source files PILNAM. MLB TESTA. MAC SPAN3.MAC and 
SHELL. MAC. 
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>MACRO/LIST/SWITCHES: (/NL: TTM: COM) FILNAM 

This command string produces an object module and an assembly 
listing. Any .LIST TTM or .LIST COM directive in the source 
file is ignored. The listing produced by this command has no 
comments included and is printed in wide format. 



8.3 IAS MACRO-11 OPERATING PROCEDURES 

The following sections describe those MACRO-11 operating procedures 
that apply exclusively to the IAS system. 



8.3.1 Initiating MACRO-11 Under IAS 

The MACRO command is used under IAS to begin MACRO-11 assembler 
operations. The command causes MACRO-11 to assemble one or more ASCII 
source files containing MACRO-11 statements into a relocatable binary 
object file. The assembler will also produce an assembly listing, 
followed by a symbol table listing, A cross-reference listing can 
also be produced, by. means of the /CROSSREFERENCE qualifier (see 
8.3.2, below). 

A MACRO-11 program can be input either directly from the terminal 
(interactive mode) or from a batch file (batch mode). For interactive 
mode use the MACRO command which can be issued whenever the IAS 
Program Development System (PDS) is at command level, a condition 
signified by the appearance of the prompt: 

PDS> 

For batch mode use the $MACRO command. 

When the assembly is completed, MACRO-11 terminates operations and 
returns control to PDS. (Refer to the IAS User's Guide for further 
information about interactive and batch mode operations.) 



8.3.2 IAS Command String 

FORMATS : 

Interactive Mode 

input 
PDS> MACRO qualifiers filespec /LIBRARY +... 

or 

PDS> MACRO qualifiers 

input 
FILES? filespec /LIBRARY +... 

Batch Mode 

input 
$MACRO qualifiers filespec /LIBRARY +... 
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where: 



input 
f ilespec 



is the specification of an input file 
(see Section 8.5) that contains MACRO-11 
source program code. When the program 
consists of multiple files, a plus sign 
(+) must be used to separate each file 
specification from the next. The "wild 
card" form of a file specification is 
not allowed. 



/LIBRARY 



specifies that an input file is a macro 
library file. Library files hold the 
definitions of externally defined 
macros. As noted in Section 7.8, an 
externally defined macro must be 
identified in an .MCALL directive before 
it can be retrieved and assembled with 
the user program. When MACRO-11 
encounters an .MCALL directive, a search 
begins for the definitions of the macros 
listed. 



qualifiers 

output 
/OBJECT [ ; f ilespec] 



The search order is important because a 
macro might have two different 
definitions in library files LIBl and 
LIB2. For example, if you need the 
definition in LIBl, then you must place 
LIBl after LIB2 in the command line 
because MACRO-11 searches the last file 
spacified in the command line first, 
then moves backwards through the files 
given until all have been searched. 

If a macro's definition is not found in 
any of the files named by the user, 
MACRO-11 automatically searches the 
system macro library; if the definition 
is still not found, an error code (U) is 
generated in the assembly listing. 

specifies one or more of the following: 

produces an object file as specified by 
filespec (see Section 8.5). The default 
is a file with the same filename as the 
last named source file and an .OBJ 
extension. /OBJECT is always the 
default condition. 



/NOOBJECT 

output 
/LIST[ : filespec] 



Does not produce an object file. 

produces an assembly listing file 
according to filespec (see Section 8.5). 
If filespec is not specified, the 
listing is printed on the line printer. 
The default in interactive mode is 
/NOLIST and in batch mode is /LIST. 

Does not produce a listing file. The 
default in interactive mode is /NOLIST 
and in batch mode is /LIST. 
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NOTE 

When no listing file is specified, any 
errors encountered in the source program 
are displayed at the terminal from which 
MACRO-11 was initiated. 



/CROSSREFERENCE [ : argl . . . arg4 ] 



produces a cross-reference listing. 
Argl through arg4 are as described in 



. 1 J . 



abbreviated to /C. 

A MACRO-11 command string can be specified using any one of the three 
formats shown above for the interactive and batch modes. In 
interactive mode, if the input file specification (filespec) does not 
begin on the same line as the MACRO command and its qualifiers, PDS 
prints the following prompting message: 

FILES? 

then waits for the user to specify the input file(s). 

In batch mode, the $MACRO command and its arguments must appear on' the 
same line unless the PDS line continuation symbol (-) is used. 



8.3.3 IAS Indirect Command Files 

FORMAT: 

§f ilespec 

where: 

§ specifies that the name that follows is an indirect 
file. 

filespec Is the file specification (see Section 8.5) of a file 
that contains a command string. The default extension 
for the file name is .CMD. 

The indirect command file facility of PDS can be used with MACRO-11 
command strings. This is accomplished by creating an ASCII file that 
contains the desired command strings (or portions thereof) in the 
forms shown in Section 8.3.2. when an indirect command file reference 
is used in a MACRO-11 command string, the contents of the specified 
file are taken as all or part of the command string. 

An indirect command file reference must always be the rightmost entry 
in the command (see Section 8.3.4 for examples). 
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8.3.4 IAS Command String Examples 

The following examples show typical PDS MACRO-11 command strings. 

1. PDS> MACRO /NOLIST 
FILES? A+B00T.MAC;3 

In this example, the source files A.MAC and B00T.MAC;3 will 
be assembled to produce an object file called BOOT. OBJ. No 
listing will be produced. 

2. Where the indirect command file TEST.CMD contains the command 
string: 

MACRO/OBJECT :MYFILE A+B 

The command: 

PDS>@TEST 

causes MACRO-11 to assemble the two files A.MAC and B.MAC 
into an object file called MYFILE.OBJ. 

3. Where the indirect command file IND02.CMD contains the 
command string segment: 

ATEST/LIBRARY+BTEST+SRTl . 021 

The command: 

PDS>MACRO/LIST:DK1:FOO @IND02 

causes MACRO-11 to assemble the files BTEST.MAC and SRT1.021 
using the macro library file ATEST.MAC to produce an object 
file named SRTl.OBJ. A listing file named FOO.LST is placed 
on disk unit 1, 

4. $MACRO/LIST:DK0:MICR/NOOBJBCT 
LIBl/LIBRARY+MICR. MAC ; 002 

In this example, the library file is assembled with the file 
MICR.MAC;002. The program listing file named MICR.LST is 
placed on disk unit 0. 



8.4 CROSS-REFERENCE PROCESSOR (CREF) 

The CREF processor is used to produce a listing that includes 
cross-references to symbols that appear in the source program. The 
cross-reference listing is appended to the assembly listing. Such 
cross-references are helpful in debugging and in reading long 
programs. 

A cross-reference listing can include up to four sections: 

1. User-defined symbols 

2. Macro symbols 

3. Register symbols 

4. Permanent symbols 
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To generate a cross-reference listing, specify the /CR switch in the 
MACRO-11 command string. Optional arguments can also be specified. 
The form of the switch is: 

SYM 
/CR : MAC 

REG 
PST 

where: 

SYM specifies user-defined symbols (default) 

MAC specifies macro symbols (default) 

REG specifies register symbols 

PST specifies permanent symbols. 

If you wish to generate listings for user-defined and macro symbols 
only, use. /CR. No argument is necessary. 

However, if an argument is specified, only that type of 
cross-reference listing is generated. For example: 

/CRrSYM 

produces a cross-reference listing of user-defined symbols only. No 
listing of macro symbols is generated. Thus, to produce all four 
types of cross-reference listings, you must specify all four arguments 

l*-U^ r^ t- .-^ r^ ^ A^ T ,U i -^U J-Urt-, -, .- ^. r--nt^ ^ ~ ^ i r^^ i<^ 1-.,-.+- r- ^ rt »^ ■« ^^ ■{ ^ -* 1-. 4- \ TTr-/^ -> 

VUiiC ULUCI- xii Wiixt^it uiic:^ cii-c; opc^-i-xxcvj io iis^L. oA^iixj-xv-ciiiu/. wot: tx 

colon to separate arguments. For example: 

/CR : REG : SY M : MAC : PST 

The CREF processor is more fully described in the Utilities Reference 
Manual supplied with your system. 

Figure 8-1 illustrates a complete cross-reference listing. In the 
listing references are made in the form: page-line. To make the 
xisting more iuxormative fue CREF Processor uses tue xOxj-owing signs: 

Sign Meaning 

= somewhere in the source program the symbol listed is 
. . - .^ <te-f-tne^ -by^ -a- -d-i-r.*** -a«&i^^wnefvt sta-t^men-t .- » - 

* destructive reference; at the line referenced by the 
processor the value of the symbol is changed (its 

^xcTvxwuo uwii!_t::iiu^ ucr^i-xv^'^'S^x; . 

# at the line referenced by the processor the symbol 
listed is defined by a direct assignment statement, a 
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R50UNP MACRO Y04.00 29-AUG-79 16i06t39 PAGE S-1 
CROSS REFERENCE TABLE (CREF UOl-08 > 



R50UNP 2-16* 

SYHBOL 2-17 2-25 



R50UNP MACRO Y04.00 29-AUG-79 16:06:39 PAGE R-1 
CROSS REFERENCE TABLE (CREF MOl-08 ) 



RO 


2-23* 


2-32* 


2-33* 




2-50* 


2-51* 


2-52 


Rl 


2-18* 


2-23 




R2 


2-52* 






R3 


2-19* 


2-21* 


2-33 


R4 


2-16 


2-17* 


2-18 


SP 


2-16* 


2-27 





-43 2-45 2-48* 2-49* 



2-25 2-27* 



R50UNP MACRO Y04.00 29-AU6-79 16:06!39 PAGE C-1 
CROSS REFERENCE TABLE (CREF VOl-08 > 



0-0 

ABS. 0-0 



PUREI 2-14 



Figure 8-1 Sample CREF Listing 



8.5 lAS/RSX-llM FILE SPECIFICATION 

FORMAT: 

dev: [g,m] name.ext; ver 



where: 



(3ev: is the name of the physical (3evice where the (3esire(3 
file resi(3es. A <3evice name consists of two characters 
followe(a by a 1- or 2-(3igit c3evice unit number (octal) 
and a colon (for example, DPI:, DKO:, DT3:). The 
default device under RSX-llM and RSX-llM-PLUS is as 
specified in Table 8-1. The default device under IAS 
is established initially by the system manager for each 
user and can be changed through the SET command. 

[g,m] is the User File Directory (UFD) code. This code 
consists of a group number (octal), a comma (,), and an 
owner (member) number (octal) all enclosed in brackets 
([]J. An example of a UFD code is: [200,30]. 

The default UFD is equivalent to the User 
Identification Code (UIC) given at log-in time. Under 
IAS, the UFD can be changed through the SET DEFAULT 
command . 

name is the filename and consists of one through nine 
alphanumeric characters. There is no default for a 
filename. 
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.ext is a 1- to 3-alphanumer ic character filename extension 
or type that is preceded by a period (.). An extension 
is normally used to identify the nature of the file. 
Default values depend on the context of the file 
specification and are as follows: 

.CMD = Indirect command (input) file 
.LST = A listing (print format) file 
.MAC = MACRO-11 source module (input file) 
.OBJ = MACRO-11 object module (output file) 
.CRF = Intermediate CREF input file created 
by MACRO-11. 

;ver is an octal number between 1 and 77777 that is used to 
differentiate between versions of the same file. This 
number must be prefixed by a semicolon (;). 



For input files, the default value is 
version number of the file that exists. 



the highest 



For output files, the default value is the highest 
version number of the file that exists increased by 1. 
If no version number exists, the value 1 is used. 

This is the general form for a file specification in lAS/RSX-llM 
systems. Detailed information is provided in the applicable system 
user's guide or operating procedures manual (see Section 0.3 in the 
Preface) . 



8.6 HACRO-11 ERROR MESSAGES UNDER lAS/RSX-llM 

MACRO-11 outputs an error message to the command output device when 
one of the error conditions described below is detected. These error 
messages reflect operational problems and should not be confused with 
the error codes (see Appendix D) produced by MACRO-11 during assembly. 

All the error messages listed in Table 8-5, with the exception of the 
"MAC — COMMAND I/O ERROR" message, result in the termination of the 
current assembly; MACRO-11 then attempts to restart by reading 
another command line. In the case of a command I/O error, however, 
MACRO-11 exits, since it is unable to obtain additional command line 
input. 



Table 8-5 
Operational Error Messages; lAS/RSX-llM 



Error Message 


Meaning 


MAC — COMMAND FILE OPEN FAILURE 


Either the file from 
which MACRO-11 is reading 
a command could not be 
opened initially or 
between assemblies; or 
the indirect command file 
specified as "@filename" 
in the MACRO-11 command 
line could not be opened. 
See "OPEN FAILURE ON 
INPUT FILE" for meaning. 



(continued on next page) 
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Table 8-5 (Cont.) 
Operational Error Messages; lAS/RSX-llM 



Error Message 



MAC — COMMAND I/O ERROR 



MAC — COMMAND SYNTAX ERROR 



MAC — ILLEGAL FILENAME 



MAC — ILLEGAL SWITCH 



MAC ~ INDIRECT COMMAND SYNTAX ERROR 



MAC — INDIRECT FILE DEPTH EXCEEDED 



Meaning 



An error was returned by 
the file system during 
mACRO-11's attempt to 
read a command line. 
This is an uncondi- 
tionally fatal error, 
causing MACRO-11 to exit. 
No MACRO-11 restart is 
attempted when this 
message appears. 

An error was detected in 
the syntax of the 
MACRO-11 command line. 

Neither the device name 
nor the filename was 
present in the input file 
specification (the input 
file specification was 
null) , or a wild card 
convention (asterisk) was 
employed in an input or 
output file specifica- 
tion, wildcard options 
(*) are not permitted in 
MACRO-11 file specifica- 
tions. 

An illegal switch was 
specified for a file, an 
illegal value was 
specified with a switch, 
or an invalid use of a 
switch was detected by 
MACRO-11. 

The name of the indirect 
command file (^filename) 
specified in the MACRO-11 
command line is 
syntactically incorrect. 

An attempt to exceed the 
maximum allowable number 
of nested indirect 
command files has 
occurred. (Only three 
levels of indirect 
command files are 
permitted in MACRO-11.) 

(continued on next page) 
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Table 8-5 (Cont.) 
Operational Error Messages; lAS/RSX-llM 



Error Message 



Meaning 



MAC — INSUFFICIENT DYNAMIC MEMORY 



MAC — INVALID FORMAT IN MACRO LIBRARY 



MAC 



I/O ERROR ON INPUT FILE 



MAC — I/O ERROR ON MACRO LIBRARY FILE 



MAC — I/O ERROR ON OUTPUT FILE 



MAC ~ I/O ERROR ON WORK FILE 



There is not enough 
physical memory available 
for MACRO-11 to page its 
symbol table. Reinstall 
MACRO-11 in a larger 
partition,. or see 
Appendix F.3. 

The library file has been 
corrupted, or it was not 
produced by the Librarian 
Utility Program (LBR) . 

In reading a record from 
a source input file or 
macro library file, the 
file system detected an 
error; for example, a 
line containing more than 
132(10) characters was 
encountered. This mes- 
sage may also indicate 
that a device problem 
exists or that either a 
source file or a macro 
library file has been 
corrupted with incorrect 
data. 

Same meaning as I/O ERROR 
ON INPUT FILE, except 
that the file is a macro 
library file and not a 
source innut file. 

In writing a record to 
the object output file or 
the listing output file, 
an error was detected by 
the file system. This 
message may also indicate 
that a device problem 
exists or that the device 
is full. 

A read or write error 
occurred on the work file 
used to store the symbol 
table. This error is 
most likely caused by a 
problem on the device or 
by attempting to write to 
a device that is full. 



(continued on next page) 
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Table 8-5 (Cont.) 
Operational Error Messages; lAS/RSX-llM 



Error Message 



Meaning 



MAC — OPEN FAILURE ON INPUT FILE 



MAC — OPEN FAILURE ON OUTPUT FILE 



MAC — 64K STORAGE LIMIT EXCEEDED 



1. 
2. 
3. 
4. 
5, 
6, 

1. 
2. 
3, 
4. 
5. 



Specified device does 

not exist. 

The volume is not 

mounted, 

A problem exists with 

the device. 

Specified directory 

file does not exist. 

Specified file does 

not exist. 

User does not have 

access to the file 

directory or to the 

file itself. 



Specified de 
not exist. 
The volume 
mounted. 
A problem ex 
the device. 
Specified 
file does no 
User does 
access to 
directory. 
The volume i 
the device 
protected. 
There is ins 
space fo 
Control Bloc 



vice does 

is not 

ists with 

directory 
t exist, 
not have 
the file 

s full or 
is write 

uf f icient 
r File 
ks. 



64K words 
memory are 
MACRO-11. 
indicates 
assembler 
so many 
13,000 to 
has run 
Either the 
is too la 
with, or i 
condition 
excessive s 
macro ex 
recursively 
without a 
condition. 



of work file 
available to 

This message 
that the 
has generated 
ymbols (about 
4,000) that it 
ut of space, 
source program 
rge to start 
t contains a 
that leads to 
ize, such as a 
pansion that 

calls itself 
terminating 
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CHAPTER 9 
RSTS/RT-11 OPERATING PROCEDURES 



9.1 MACRO-11 UNDER RSTS 

The only way a MACRO-11 program can run on a RSTS system is through 
either the RT-11 or RSX run-time systems. 



9.1.1 RT-11 Through RSTS 

There are two ways to run a MACRO program under the RT-11 run-time 
system: 

1. Use the RT-11 Emulator. This is done by typing: S',\ RTll- 
The terminal will respond with the RT-11 prompt (a dot 
printed by the keyboard monitor). You can then use the RT-11 
commands 'see Section 9.2) . 

2. Type the command: run SmaCRO.SAV. The terminal will respond 
with an asterisk (*) prompt. You can then enter a command 
string of the form: 

OBJFIL,LSTFIL=SRC. . .SRC6 

where: OBJFIL is an object (output) file with the default 
extension .OBJ. 

LSTFIL is a listing (output) file with the default 
extension .LST. 

SRC... are source (input) files with the default 
SRC6 extension .MAC. Six input files are allowed 
in this command. 



9.1.2 RSX Through RSTS 

To run a MACRO program under the RSX run-time system, type the 
command: RUN $MAC.TSK. The terminal will respond with: 

MAO 
In answer you enter a command string of the form: 
OBJFIL, LSTFIL=SRC. . .SRCN 
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where: OBJFIL is an object (output) file with the default 

extension .OBJ. 

LSTFIL is a listing (output) file with the default 
extension .LST. 

SRC... are source (input) files with the default 
SRCN extension .MAC. 



NOTE 

There are other commands that can be 
used to call RT-11 and RSX but they are 
site dependent and so are not mentioned 
here. 



9.2 INITIATING MACRO-11 UNDER RT-11 

The following sections describe those MACRO-11 operating procedures 
that apply only to the RT-11 system. 

To call the MACRO-11 assembler from the system device, respond to the 
system prompt (a dot printed by the keyboard monitor) by typing: 

R MACRO 

When the assembler responds with an asterisk (*) , it is ready to 
accept command string input. 



9.3 RT-11 COMMAND STRING 
FORMAT : 

[dev:obj ,dev:list,dev:cref/s:arg]=dev: srcl ,src2, . . . ,dev:srcn/s:arg 



where 



dev is any legal RT-11 device for output; any 
file-structured device for input 

obj is the file specification of the binary object file 
that the assembly process produces; the device for 
this file should not be TT or LP 

list is the file specification of the assembly and symbol 
listing that the assembly process produces 

cref is the file specification of the CREF temporary 
cross-reference file that the assembly process 
produces. (Omission of dev:cref does not preclude a 
cross-reference listing, however.) 

/s:arg is a set of file specification options and arguments 
(see Section 9.2) . 

srcl, represent the ASCII source (input) files containing the 
src2,... MACRO-11 source program or the user-supplied macro 
srcn library files to be assembled. You can specify as many 
as six source files. 
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The following command string calls for an assembly that uses one 

source file plus the system MACRO library to produce an object file 

BINF.OBJ and a listing. The listing goes directly to the line 
printer. 

*DK ; BINK . OBJ , LP : =DK : SRC . MAC 

All output file specifications are optional. The system does not 
produce an output file unless the command string contains a 
specification for that file. 

The system determines the file type of an output file specification by 

commas in the string. For example, to omit the object file, you must 
begin the command string with a comma. The following command produces 
a listing, including cross-reference tables, but not binary object 

files. 

*,LP:/C=(source file specification) 

Notice that you need not include a comma after the final output file 
specification in the command string. 

Table 9-1 lists the default values for each file specification. 



Table 9-1 
Default File Specification Values 





Default 


Default 


Default 


File 


Device 


File Name 


File Type 


Object 


DK: 


Must specify 


.OBJ 


Listing 


Same as for object 
file 


Must specify 


.LST 


Cref 


DK: 


Must specify 


.TMP 


First source 


DK: 


Must specify 


.MAC 


Additional source 


Same as for preceding 
source file 


Must specify 


.MAC 


System MACRO 


System device SY: 


SYSMAC 


.SML 


Library 








User MACRO 


DK: if first file, 


Must specify 


• MAC 


Library 


otherwise same as for 
preceding source file 
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NOTE 

Some assemblies need more symbol table 
space than available memory can contain. 
When this occurs the system 
automatically creates a temporary work 
file called WRK.TMP to provide extended 
symbol table space. 

The default device for WRK.TMP is DK. 
To cause the system to assign a 
different device, enter the following 
command : 

.ASSIGN dev: WF 



where: 



dev 



is the 

device 

WRK.TMP. 



file- structured 
that will hold 



9.4 FILE SPECIFICATION OPTIONS 

At assembly time you may need to override certain MACRO directives 
appearing in the source programs. You may also need to direct 
MACRO-11 on the handling of certain files during assembly. You can 
satisfy these needs by using the switches described in Table 9-2. 



Table 9-2 
File Specification Options 



Option 



Usage 



/L?arg 
/N:arg 



/E:arg 
/D:arg 



/M 



Listing control switches; these options accept ASCII 
switch values (arg) which are equivalent in function 
and name to the arguments of the .LIST and .NLIST 
directives specified in the source program (see 
Section 6.1.1). This switch overrides the arguments 
of the directives and remains in effect for the 
entire assembly process. 

Function control switches? these options accept ASCII 
switch values (arg) which are equivalent in function 
and name to the arguments of the .ENABL and .DSABL 
directives specified in the source program {see 
Section 6.2). This switch overrides the arguments of 
the directives and remains in effect for the entire 
assembly process. 



Indicates input file is MACRO library 
assembler encounters an .MCALL dir 
source code, it searches macro librari 
their order of appearance in the 
When it locates a macro record whose 
that given in the .MCALL, it assembl 
indicated by that definition. Thus, i 
macro libraries contain definitions of 
name, the macro library that appears 1 
command string takes precedence. 



file. When the 
ective in the 
es according to 
command string, 
name matches 
es the macro as 
f two or more 
the same macro 
eftmost in the 



(continued on next page) 
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Table 9-2 (Cont.) 
File Specification Options 



Option 



Usage 



/M (cont.) 



/C:arg 
/P:l 

/P:2 



Consider the following command string: 

*(output file specif ication)=ALIB.MAC/M, 
BLIB.MAC/M,XIZ 



1. 



-r m J 



ftsauiue uiiav. eduii ujl uiie two macto axul ax. xes , ftjjXD anu 

BLIB, contain a macro called .BIG, but with different 
definitions. Then, if source file XIZ contains a 
macro call .MCALL .BIG, the system includes the 
definition of .BIG in the program as it appears in 
the macro library ALIB. 

If the command string does not include the standard 
system macro library SYSMAC.SML, the system 
automatically includes it as the last source file in 
the command string. Therefore, if macro library ALIB 
contains a definition of a macro called .READ, that 
definition of .READ overrides the standard .READ 
macro definition in SYSMAC.SML. 

Controls contents of cross-reference listing. 

Assembles the associated file during assembly pass 1 
j only. 

i Assembles the associated file during assembly pass 2 
; only. 



The /M and /P switches affect only the source file to which they are 
appended. The other options affect the entire command string. 



9.5 CROSS-REFERENCE (CREF) TABLE GENERATION OPTION 

A cross-reference (CREF) table lists all or a subset of the symbols in 
a source program, identifying the statements that define and use 
symbols. 



9.5.1 Obtaining a Ctoss-Reference Table 

To obtain a CREF table you must include the /C:arg option in the 
command string. Usually you include the /C:arg option with the 
assembly listing file specification. 

If the command string does not include a cref file specification, the 
system automatically generates a temporary file on device DK:. If you 
need to have a device other than DK: contain the temporary cref file, 
vou must include the dev:cref field in the command string. 
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A complete CREF listing contains the following six sections: 

1. A cross reference of program symbols — labels used in the 
program and symbols followed by an operator. 

2. A cross reference of register equate symbols — symbols defined 
in the program by the construct: 

symbol-n 

with 0>n>7. 

Normally, these symbols include RO , Rl , R2 , R3 , R4 , R5 , SP, 
and PC. 

3. A cross reference of MACRO symbols — those symbols defined by 
.MACRO and .MCALL directives. 

4. A cross reference of permanent symbols — all operation 
mnemonics and assembler directives. 

5. A cross reference of program sections — the names you specify 
as operands of .CSECT or .PSECT directives. 

6. A cross reference of errors — the system groups and lists all 
flagged errors from the assembly by error type. 

You can include any or all of these six sections on the 
cross-reference listing by specifying the appropriate arguments with 
the /C option. These arguments are listed and described in Table 9-3. 

Table 9-3 
/C Option Arguments 



Argument 


CREF Section 


S 


User defined symbols 




R 


Register symbols 




M 


MACRO symbolic names 




P 


Permanent symbols including instructions 


and directives 


C 


Control and program sections 




E 


Error code grouping 





NOTE 

Specifying /C with no arguments is 
equivalent to specifying /C:S:M:E. That 
special case excepted, you must 
explicitly request each CREF section by 
including its arguments. No 
cross-reference file occurs if the /C 
option is not specified, even if the 
command string includes a CREF file 
specification. 
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9.5.2 Handling Cross-Reference Table Files 

When you request a cross-reference listing by means of the /C option, 
you cause the system to generate a temporary file, DK:CREF.TMP. 

If device DK: is write-locked or if it contains insufficient free 
space for the temporary file, you can allocate another device for the 
file. To allocate another device, specify a third output file in the 
command string; that is, include a dev:cref specification. (You must 
still include the /C option to control the form and content of the 
listing. The dev:cref specification is ignored if the /C option is 
not also present in the command string.) 

The system then uses the dev:cref file instead of DK:CREF.TMP and 
deletes it automatically after producing the CREF listing. 

The following command string causes the system to use RK2:TEMP.TMP as 
the temporary CREF file. 

* ,LP: ,RK2:TEMP.TMP=S0URCE/C 

Another way to assign an alternative device for the CREF.TMP file is 
to enter the following command prior to entering R MACRO: 

.ASSIGN devtCF 

This method is preferred if you intend to do several assemblies, as it 
relieves you from having to include the devicref specification in each 
command string. If you enter the ASSIGN dev: CF command, and later 
include a cref specification in a command string, the specification in 
the command string prevails for that assembly only. 

The system lists requested cross-reference tables following the MACRO 
assembly listing. Each table begins on a new page. 

The system prints symbols and also symbol values, control sections, 
and error codes, if applicable, beginning at the left margin of the 
page. References to each symbol are listed on the same line, 
left-to-right across the page. The system lists references in the 
form P-L; where P is the page in which the symbol, control section, 
or error code appears, and L is the line number on the page. 

A number sign (#) next to a reference indicates a symbol definition. 
An asterisk (*) next to a reference indicates a 

destructive reference — an operation that alters the contents of the 
addressed location. 



9.5.3 MACRO-11 Error Messages Under RT-11 

MACRO-11 outputs an error message to the command output device when 
one of the error conditions described below is detected. These error 
messages reflect operational problems and should not be confused with 
the error codes (see Appendix D) produced by MACRO-11 during assembly. 
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Error Message Meaning 

?MACRO-F-Bad option The specified option was not recognized by 

the program. 

?MACRO-F-Device full The output volume does not have sufficient 

room for an output file specified in the 
command string. 

?MACRO-F-File not found An input file in the command line does not 

exist on the specified device. 

?MACRO-F-Illegal command The command line contains a syntax error or 

specifies more than 6 input files. 

?MACRO-F-Illegal device A device specified in the command line does 

not exist on the system. 

?MACRO-F-Insuf f icient memory 

There were too many symbols in the program 
being assembled, 

?MACRO-W-I/0 error on cref file: cref file aborted 

MACRO ran out of device space while writing 
the cref file, or a hardware error has 
occurred. The cref file is aborted but 

assembly continues. 

7MACR0-F-I/0 error on dev: f ilenm. ext 

A hardware error occurred while attempting to 
read from or write to the device on the 
specified channel. 

?MACRO-F-I/0 error on work file 

MACRO failed to open, read or write to its 
work file, WRK.TMP. 

?MACRO-F-Invalid macro library 

The library file has been corrupted or it was 
not produced by the RT-11 librarian, LIBR. 

?MACRO-F-Output device full 

There was no room to continue writing the 
output file. 

?MACRO-F-Read error on MACRO library 

MACRO detected a bad record in the MACRO 
library. For example, this error occurs when 
the library area is bad. 

?MACRO-F-Storage limit exceeded (64K) 

MACRO'S Virtual Symbol Table can store 
symbols and macros up to 64K in any 
combination. Your program contains more than 
64K worth of one or both of these elements. 
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A.l ASCII CHARACTER SET 



EVEN 

PARITY 

BIT 




1 

1 



1 





1 
1 



1 



1 
1 



1 





7-BIT 
OCTAL 
CODE 



000 
001 

002 

003 

004 

005 

006 
007 
010 



Oil 
012 



013 
014 

015 

016 

017 

020 
021 



023 



024 



CHARACTER 



NUL 
SOH 

STX 

ETX 

EOT 

ENQ 

ACK 
BEL 
BS 



HT 
LF 



VT 
FF 

CR 

SO 

SI 

DLE 
DCl 



DC3 



DC 4 



REMARKS 



Of 



Of 



Null, tape feed, CONTROL/SHIFT/P. 

Start of heading; also SOM, start 

of message, CONTROL/A. 

Start of text; also EOA, end 

address, CONTROL/B. 

End of text; also EOM, end 

message, CONTROL/C. 

End of transmission (END) ; shuts 

off TWX machines, CONTROL/D. 

Enquiry (ENQRY) ; also WRu , 

CONTROL/E . 

Acknowledge; also RU , CONTROL/F. 

Rings the bell. CONTROL/G. 

Backspace; also FEO, format 

effector. backspaces some 

machines, CONTROL/H. 

Horizontal tab. CONTROL/I. 

Line feed or Line space (new line) ; 

advances paper to next line, 

duplicated by CONTROL/J . 

Vertical tab (VTAB) . CONTROL/K. 

Form Feed to top of next page 

(PAGE). CONTROL/L. 

Carriage return to beginning of 

line; duplicated by CONTROL/M. 

Shift out; changes ribbon color to 

red. CONTROL/N. 

Shift in; changes ribbon color to 

black. CONTROL/O. 

Data link escape. CONTROL/P (DCO) . 

Device control 1; turns 

transmitter (READER) on, CONTROL/Q 

(X ON) . 022 DC2 Device control 

2; turns punch or auxiliary on. 

CONTROL/R (TAPE, AUX ON). 

Device control 3; turns 

transmitter (READER) off, CONTROL/S 

i-i ncuN 

Device control 4; turns 



auxiliary 
OFF) . 



off. 



punch or 
CONTROL/T (AUX 
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EVEN 


7-BIT 






PARITY 


OCTAL 






BIT 


CODE 


CHARACTER 


REMARKS 


1 


025 


NAK 


Negative acknowledge; also ERR, 
ERROR. CONTROL/U. 


1 


026 


SYN 


Synchronous file (SYNC) . 
CONTROL/V . 





027 


ETB 


End of transmission block; also 
LEM, logical end of medium. 
CONTROL/W. 





030 


CAN 


Cancel (CANCL) , CONTROL/X. 


1 


031 


EM 


End of medium. CONTROL/Y. 


1 


032 


SUB 


Substitute. CONTROL/Z. 





033 


ESC 


Escape. CONTROL/SHIFT /K. 


1 


034 


FS 


File separator. CONTROL/SHIFT/L. 





035 


GS 


Group separator. CONTROL/SHIFT/M. 





036 


RS 


Record separator. CONTROL/SHIFT/N. 


1 


037 


US 


Unit separator. CONTROL/SHI FT/O. 


1 


040 


SP 


Space. 





041 


! 







042 


II 




1 


043 


# 







044 


$ 




1 


045 


% 




1 


046 


& 







047 


' 


Accent acute or apostrophe. 





050 


( 




1 


051 


) 




1 


052 


* 







053 


+ 




1 


054 


f 







055 


_ 







056 


, 




1 


057 


/ 







060 







1 


061 


1 




1 


062 


2 







063 


3 




1 


064 


4 







065 


5 







066 


6 




1 


067 


7 




1 


070 


8 







071 


9 







072 


• 




1 


073 


• 

r 







074 


< 




1 


075 


= 




1 


076 


> 







077 


7 




1 


100 


h 







101 


A 







102 


B 




1 


103 


C 







104 


D 




1 


105 


E 




1 


106 


F 







107 


G 







110 


H 







111 


I 
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EVEN 

PARITY; 

BIT 



7-BIT 
OCTAL 
CODE 



CHARACTER 



REMARKS 



1 


1 



1 



1 

~l 

J. 



1 




1 
1 




1 



1 

1 






112 
113 
114 
115 
116 
117 
120 
121 
122 
123 
124 
125 
126 
127 
130 
131 
132 
133 
134 
135 
136 
137 
140 



J 
K 
L 
M 
N 

P 
Q 
R 
S 
T 
U 
V 

w 

X 
Y 
Z 
[ 

\ 
] 





141 


a 




142 


b 




143 


c 




144 


d 




145 


e 




146 


f 




147 


q 




150 


h 




151 


i 




152 


1 




153 


k 




154 


1 




155 


m 




156 


n 




157 


o 




160 


P 




161 


q 




162 


r 




163 


s 




164 


t 


1 


165 


u 




166 


V 





167 


w 


Q 


170 


X 


1 


171 


y 


1 


172 


z 





173 


{ 


1 


174 


1 





175 


} 





176 


Oi 



shift/k. 

shift/1. 

shift/m. 

* 

** 

Accent grave. 



177 



DEL 



I This code generated by ALTMODE. 

I This code generated by prefix key 

' Delete, Rubout. 



Appears as # or " on some machines. 



Appears as < on some machines. 
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A. 2 RADIX-50 CHARACTER SET 





ASCII 






Octal 


Radix-50 


Character 


Equivalent 


Equivalent 


Space 


40 





A-Z 


101-132 


1-32 


$ 


44 


33 


. 


56 


34 


Unused 




35 


0-9 


60-71 


36-47 



The maximum Radix-50 value is, thus, 

47*50**2+47*50+47=174777 

The following table provides a convenient means of translating 
between the ASCII character set and its Radix-50 equivalents. 
For example, given the ASCII string X2B, the Radix-50 
equivalent is (arithmetic is performed in octal) : 

X=113000 

2=002400 

B=000002 

X2B=115402 



Single 


' Char. 












or 


Second 




Third 




First 


Char. 


Charad 


ter 


Character 


Space 


000000 


Space 


000000 


Space 


000000 


A 


003100 


A 


000050 


A 


000001 


B 


006200 


B 


000120 


B 


000002 


C 


011300 


C 


000170 


C 


000003 


D 


014400 


D 


000240 


D 


000004 


E 


017500 


E 


000310 


E 


000005 


F 


022600 


F 


000360 


F 


000006 


G 


025700 


G 


000430 


G 


000007 


H 


031000 


H 


000500 


H 


000010 


I 


034100 


I 


000550 


I 


000011 


J 


037200 


J 


000620 


J 


000012 


K 


042300 


K 


000670 


K 


000013 


L 


045400 


L 


000740 


L 


000014 


M 


050500 


M 


001010 


M 


000015 


N 


053600 


N 


001060 


N 


000016 





056700 





001130 





000017 


P 


062000 


P 


001200 


P 


000020 


Q 


065100 


Q 


001250 


Q 


000021 


R 


070200 


R 


001320 


R 


000022 


S 


073300 


S 


001370 


S 


000023 


T 


076400 


T 


001440 


T 


000024 


U 


101500 


U 


001510 


U 


000025 
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Single Char. 










or 


Second 




Third 




First Char. 


Character 


Character 


V 104600 


V 


001560 


V 


000026 


W 107700 


W 


001630 


W 


000027 


X 113000 


X 


001700 


X 


000030 


Y 116100 


Y 


001750 


Y 


000031 


2 121200 


Z 


002020 


Z 


000032 


$ 124300 


$ 


002070 


$ 


000033 


127400 


• 


002140 


, 


000034 


Unused 132500 


Unused 


002210 


Unused 


000035 


135600 





002260 





000036 


1 140700 


1 


002330 


1 


000037 


2 144000 


2 


002400 


2 


000040 


3 147100 


3 


002450 


3 


000041 


4 152200 


4 


002520 


4 


000042 


5 155300 


5 


002570 


5 


000043 


6 160400 


6 


002640 


6 


000044 


7 163500 


7 


002710 


7 


000045 


8 166600 


8 


002760 


8 


000046 


9 171700 


9 


003030 


9 


000047 
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B.l SPECIAL CHARACTERS 



Character 


Function 


• 
• 


Label terminator 


= 


Direct assignment operator 




Register term indicator 


tab 


Item terminator or field terminator 


space 


Item terminator or field terminator 


# 


Immediate expression indicator 


@ 


Deferred addressing indicator 


( 


Initial register indicator 


) 


Terminal register indicator 


, (comma) 


Operand field separator 


1 


Comment field indicator 


+ 


Arithmetic addition operator or auto 




increment indicator 


- 


Arithmetic subtraction operator or auto 




decrement indicator 


* 


Arithmetic multiplication operator 


/ 


Arithmetic division operator 


& 


Logical AND operator 


I 


Logical OR operator 


II 


Double ASCII character indicator 


' (apostrophe) 


Single ASCII character indicator or 




concatenation indicator 


. 


Assembly location counter 


< 


Initial argument indicator 


> 


Terminal argument indicator 




Universal unary operator or argument 




indicator 


\ 


Macro call numeric argument indicator 


vertical tab 


Source line terminator 



B.2 SUMMARY OF ADDRESS MODE SYNTAX 

Symbols used in the table: 

n is an integer, to 7 , representing a register number 

R is a register expression 

E is an expression 

ER is either a register expression or an expression whose value 
is in the range to 7 . 
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Format 


Address 

Mode 

Name 


Address 

Mode 

Number 


Meaning 


R 


Register 


On 


Register R contains the 
operand. 


@R or 
(ER) 


Register 
deferred 


In 


Register R contains the ad- 
dress of the operand. 


{ER) + 


Autoincrement 


2n 


The contents of the register 
specified as (ER) are 
incremented after being used 
as the address of the operand. 


@(ER)+ 


Autoincrement 
Deferred 


3n 


The register specified as (ER) 
contains the pointer to the 
address of the operand; the 
register (ER) is incremented 
after use. 


-(ER) 


Autodecrement 


4n 


The contents of the register 
specified as (ER) are 
decremented before being used 
as the address of the operand. 


@-(ER) 


Autodecrement 
Deferred 


5n 


The contents of the register 
specified as (ER) are 
decremented before being used 
as the pointer to the address 
of the operand. 


E(ER) 


Index 


6n 


The expression E, plus the 
contents of the register 
specified as (ER) , form the 
address of the operand. 


§E{ER) 


Index Deferred 


7n 


The expression E, plus the 
contents of the register 
specified as (ER) , yield a 
pointer to the address of the 
operand. 


#E 


Immediate 


27 


The expression E is the 
operand itself. 


@#E 


Absolute 


37 


The expression E is the 
address of the operand. 


E 


Relative 


67 


The address of the operand E, 
relative to the instruction, 
follows the instruction. 


@E 


Relative 
Deferred 


77 


The address of the operand is 
pointed to by E whose address, 
relative to the instruction, 
follows the instruction. 
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B.3 ASSEMBLER DIRECTIVES 



The MACRO-11 assembler directives are summarized in the following 
table. For a detailed description of each directive, the table 
contains references to the appropriate sections in the body of the 
manual. 




Section 
Reference 



Operation 



6.3.3 



one ASCII character 



^dfua ui. Oyhe) 



6.3.3 



Followed by 

a sinyle Quote 

generates a word which contains the 

7-bit ASCII representation of the 

character in the low-order byte and 

zero in the high-order byte. This 

character is also used as a 

concatenation indicator in the 

expansion of macro arguments. 

Followed by two ASCII characters a 
double quote generates a word which 
contains the 7-bit ASCII 
representation of the two 
characters. The first character is 
stored in the low-order byte; the 
second character is stored in the 
high-order byte. 



Bn 


6.4.1.2 


1 
A temporary radix control, causes 
the value n to be treated as a 

binary number. ; 

i 


^Cexpr 


6.4.2.2 


A temporary numeric control, causes 
the expression's value to be ones- 
complemented. 


"on 


6.4.1.2 


A temporary radix control, causes 
the value n to be treated as a 
decimal number. 


"Fn 


6.4.2.2 


A temporary numeric control, causes 
the value n to be treated as a 
sixteen-bit floating-point number. 


"On 


6.4.1.2 


A temporary radix control, causes 
the value n to be treated as an 
octal number. 


"Rccc 


6.3.7 


Converts ccc to Radix-50 form. 


.ASCII /string/ 

i 


6.3.4 


Generates a block of data 
containing the ASCII equivalent of 
the character string (enclosed in 
delimiting characters) , one 
character per byte. 
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Form 


Section 
Reference 


Operation 


.ASCIZ /string/ 


6,3,5 


Generates a block of data 
containing the ASCII equivalent of 
the character string (enclosed in 
delimiting characters) , one 
character per byte, with a zero 
byte terminating the specified 
string. 


•ASECT 


6.7.2 


Begins or resumes the absolute 
program section. 


•BLKB exp 


6.5.3 


Reserves a block of storage space 
whose length in bytes is determined 
by the specified expression. 


.BLKW exp 


6,5,3 


Reserves a block of storage space 
whose length in words is determined 
by the specified expression. 


.BYTE expl,exp2, . . 


6,3,1 


Generates successive bytes of data; 
each byte contains the value of the 
corresponding specified expression. 


.CSECT [name] 


6.7,2 


Begins or resumes named or unnamed 
relocatable program section. This 
directive is provided for 
compatibility with other PDP-11 
assemblers. 


.DSABL arg 


6,2 


Disables the function specified by 
the argument. 


.ENABL arg 


6.2 


Enables (invokes) the function 
specified by the argument. 


•END [exp] 


6.6,1 


Indicates the logical end of the 
source program. The optional 
argument specifies the transfer 
address where program execution is 
to begin. 


.ENDC 


6,9,1 


Indicates the end of a conditional 
assembly block. 


.ENDM [name] 


7,1,2 


Indicates the end of the current 
repeat block, indefinite repeat 
block, or macro definition. The 
optional name, if used, must be 
identical to the name specified in 
the macro definition. 


,ENDR 


7,7 


Indicates the end of the current 
repeat block. This directive is 
provided for compatibility with 
other PDP-11 assemblers. 
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Form 


Section 
Reference 


Operation 


.EOT 


6.6.2 


Ignored, indicates end-of-tape 
which is detected automatically by 
the hardware. It is included for 
compatibility with earlier 
assemblers. 


.ERROR exp;text 


7.5 


A user-invoked error directive, 
causes output to the listing file 
or tue coirimariu ouupuu Mcvice 
containing the optional expression 
and the statement containing the 
directive. 


.EVEN 


6.5.1 


Ensures that the current location 
counter contains an even address by 
adding 1 if it is odd. 


.FLT2 argl ,arg2, . . . 


6.4.2.1 


Generates successive 2-word 
floating-point equivalents for the 
floating-point numbers specified as 

arguments. 


.FLT4 argl,arg2, . . . 

i 


6.4.2.1 


Generates successive 4-word 
floating-point equivalents for the 
floating-point numbers specified as 
arguments. 


.GLOBL syml , sym2 , . . . 


6.8 


Defines the symbol specified as 
global symbol. 


.IDENT /string/ 


6.1.5 


Provides a means of labeling the 
object module with the program 
version number. The version number 
is the Radix-50 string appearing 
between the paired delimiting 
characters. 


.IF cond,argl 


6.9.1 


Begins a conditional assembly block 
of source code which is included in 
the assembly only if the stated 
condition is met with respect to 
the argufflent<9) specified. 


.IFF 


6.9.2 


Appears only within a conditional 
assembly block, indicating the 
beginning of a section of code to 
be assembled if the condition upon 
entering the block tests false. 


.IFT 


6.9.2 


Appears only within a conditional 
assembly block, indicating the 
beginning of a section of code to 
be assembled if the condition upon 
entering the block tests true. 


.IFTF 


6.9.2 


Appears only within a conditional 
assembly block, indicating the 
beginning of a section of code to 
be assembled unconditionally. 
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MACRO-11 ASSEMBLY LANGDAGE AND ASSEMBLER DIRECTIVES 



Form 



Section 
Reference 



Operation 



•IIF cond,arg, 
statement 



•IRP sym, 
<argl ,arg2, > 



, IRPC sym,<string> 



.LIMIT 



■LIST [arg] 



.MACRO name,argl, 
arg2 , . . . 



.MCALL argl,arg2,, 



,MEXIT 



.NARG symbol 



,NCHR symbol ,<string> 



6.9.3 



7.6.1 



7.6.2 



6.5.4 



6.1.1 



7.1.1 



7.8 



7.1.3 



7.4.1 



7.4.2 



Acts as a 1-line conditional 
assembly block where the condition 
is tested for the argument 
specified. The statement is 
assembled only if the condition 
tests true. 

Indicates the beginning of an 
indefinite repeat block in which 
the symbol specified is replaced 
with successive elements of the 
real argument list enclosed within 
angle brackets. 

Indicates the beginning of an 
indefinite repeat block in which 
the specified symbol takes on the 
value of successive characters, 
optionally enclosed within angle 
brackets. 

Reserves two words into which the 
Task Builder inserts the low and 
high addresses of the task image. 

Without an argument, the .LIST 
directive increments the listing 
level count by 1. With an 
argument, this directive does not 
alter the listing level count, but 
formats the assembly listing 
according to the argument 
specified. 



Indicates 
definition 
name and 
arguments. 



the start of a macro 

having the specified 

the following dummy 



Specifies the symbolic names of the 
user or system macro definitions 
required in the assembly of the 
current user program, but which are 
not defined within the program. 

Causes an exit from the current 
macro expansion or indefinite 
repeat block. 

Appearing only within a macro 
definition, equates the specified 
symbol to the number of arguments 
in the macro call currently being 
expanded. 

Appearing anywhere in a source 
program, equates the symbol 
specified to the number of 
characters in the specified string. 
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MACRO-11 ASSEMBLY LANGUAGE AND ASSEMBLER DIRECTIVES 



j .PRINT exp; text 



Form 


Section 
Reference 


Operation 


.NLIST [arg] 


6.1.1 


Without an argument, decrements the 
listing level count by 1. With an 
argument, this directive suppresses 
that portion of the listing 
specified by the argument. 


.NTYPE symbol, aexp 


7.4.3 


Appearing only within a macro 
definition, equates the symbol to 
the 6-bit addressing mode of the 
specified address expression. 


.ODD 


6.5.2 


Ensures that the current location 
counter contains an odd address by 
adding 1 if it is even. 


.PACKED 


6. J. 8 


Causes a decimal number of 31(10) 
digits or less to be packed 2 
digitG per bvte. 


.PAGE 


6.1.6 


Causes the assembly listing to skip 
to the top of the next page and to 
increment the page count. 



7.5 



User-invoked message directive; 
causes output to the listing file 
or the command output device 
containing the optional expression 
and the statement containing the 
directive. 



I .PSECT name,attl , 
i attn 



.RADIX n 



,RAD50 /string/ 



. REPT exp 



.RESTORE 



6.7.1 



6.4.1.1 



6.3.6 



7.7 



6.7.4 



Begins or resumes a named or 
unnamed program section having the 
specified attributes. 

Alters the current program radix to 
n, where n is 2, 8, or 10. 

Generates a block of data 
containing the Radix-50 equivalent 
of the character string enclosed 
within delimiting characters. 

Begins a repeat block; causes the 
section of code up to the next 
.ENDM or .ENDR directive to be 
repeated the number of times 
specified as exp. 

Retrieves a previously .SAVBd 
program section from the top of the 
program section context stack 
leaving the current program section 
in effect. 
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Form 


Section 

Reference 


Operation 


.SAVE 

.SBTTL string 

.TITLE string 
.WORD expl,exp2, . . 


6.7.3 

6.1.4 

6.1.3 
6.3.2 


Stores tho current program section 
on the top of the program section 
context stack icavinq the current 
program section in effect. 

Causes the specified string to be 
printed as part of the assembly 
listing page header. The string 
component of each .SBTTL directive 
is collected into a table of 
contents at the beginning of the 
assembly listing. 

Assigns the first six Radix-50 
characters in the string as an 
object module name and causes the 
string to appear on each page of 
the assembly listing. 

Generates successive words of data; 
each word contains the value of the 
corresponding specified expression. 
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APPENDIX C 
PERMANENT SYMBOL TABLE (PST) 



The mnemonics for the PDP-11 operation (op) codes and MACRO-11 
assembler directives are stored in the Permanent Symbol Table (PST) . 
The PST contains the symbols that are automatically recognized by 
MACRO-11. 

For a detailed description of the op codes, see the PDP-11 Processor 
Handbook. 



C.l OP CODES 



Instruction 
Mnemonic 



ADC 

ADCB 

ADD 

ASH 

ASHC 

ASL 

ASLB 

ASR 

ASRB 

BCC 

BCS 

BEQ 

BGE 

BGT 

BHl 

BHIS 

BIG 

BICB 

BIS 

BISB 

BIT 

BITB 

BLE 

BLO 

BLOS 

BLT 

BMI 

BNE 

BPL 

BPT 

BR 

BVC 

BVS 



Octal 
Value 



005500 
105500 
060000 
072000 
073000 
006300 
106300 
006200 
106200 
103000 
103400 
001400 
002000 
003000 
101000 
103000 
040000 
140000 
050000 
150000 
030000 
130000 
003400 
103400 
101400 
002400 
100400 
001000 
100000 
000003 
000400 
102000 
102400 



Operation 



Add Carry 

Add Carry (Byte) 

Add Source To Destination 

Shift Arithmetically 

Arithmetic Shift Combined 

Arithmetic Shift Left 

Arithmetic Shift Left (Byte) 

Arithmetic Shift Right 

Arithmetic Shift Right (Byte) 

Branch If Carry Is Clear 

Branch If Carry Is Set 

Branch If Equal 

Branch If Greater Than Or Equal 

Branch If Greater Than 

Branch If Higher 

Branch If Higher Or Same 

Bit Clear 

Bit Clear (Byte) 

Bit Set 

Bit Set (Byte) 

Bit Test 

Bit Test (Byte) 

Branch If Less Than Or Equal 

Branch If Lower 

Branch If Lower Or Same 

Branch If Less Than 

Branch If Minus 

Branch If Not Equal 

Branch If Plus 

Breakpoint Trap 

Branch Unconditional 

Branch If Overflow Is Clear 

Branch If Overflow Is Set 
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Instruction 

Mnemonic 



CALL 

CCC 

CLC 

CLN 

CLR 

CLRB 

CLV 

CLZ 

CMP 

CMPB 

COM 
COMB 

DEC 
DECS 

DIV 

EMT 

FADD 

FDIV 

FMUL 

FSUB 

HALT 

INC 

INCB 

lOT 

JMP 

JSR 

MARK 

MED6X 

MED74C 

MFPI 

MFPS 

MFPT 

MOV 

MOVB 

MTPI 

MTPS 

MUL 

NEC 

NEGB 

NOP 

RESET 

RETURN 

ROL 

ROLE 

ROR 

RORB 

RTI 



Octal 
Value 



004700 
000257 
000241 
000250 
005000 
105000 
000242 
000244 
020000 

120000 

005100 
105100 

005300 
105300 

071000 
104000 
075000 
075030 
075020 
075010 
000000 
005200 
105200 

000004 
000100 
004000 
006400 
076600 
076601 
006500 

106700 

000007 
010000 
110000 

006600 

106400 

070000 
005400 
105400 
000240 
000005 
000207 



Operation 





006100 




106100 




006000 




106000 




000002 



Jump TO Subroutine (JSR PC,xxx) 
Clear All Condition Codes 
Clear C Condition Code Bit 
Clear N Condition Code Bit 
Clear Destination 
Clear Destination (Byte) 
Clear V Condition Code Bit 
Clear Z Condition Code Bit 
Compare Source To 

Destination 
Compare Source To 

Destination (Byte) 
Complement Destination 
Complement Destination 

(Byte) 
Decrement Destination 
Decrement Destination 

(Byte) 
Divide 

Emulator Trap 
Floating Add 
Floating Divide 
Floating Multiply 
Floating Subtract 
Halt 

Increment Destination 
Increment Destination 

(Byte) 
Input/Output Trap 
Jump 

Jump To Subroutine 
Mark 

PDP-11/60 Maintenance 
PDP-11/74 CIS Maintenance 
Move From Previous 

Instruction Space 
Move from PS 

(LSI-11, LSI-11/23, LSI-11/2) 
Move From Processor Type 
Move Source To Destination 
Move Source To Destination 

(Byte) 
Move To Previous 

Instruction Space 
Move to PS 

(LSI-11, LSI-11/23, LSI-11/2) 
Multiply 

Negate Destination 
Negate Destination (Byte) 
No Operation 
Reset External Bus 
Return From Subroutine (RTS PC) 
Rotate Left 
Rotate Left (Byte) 
Rotate Right 
Rotate Right (Byte) 
Return From Interrupt 
(Permits a trace 

trap) 
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Instruction 




Octal 




Mnemonic 


Value 


Operation 


RTS 


000200 


Return From Subroutine 


RTT 


000006 


Return From Interrupt 
(inhibits trace trap) 


SBC 


005600 


Subtract Carry 


SBCB 


105600 


Subtract Carry (Byte) 


sec 


000277 


Set All Condition Code Bits 


SEC 


000261 


Set C Condition Code Bit 


SEN 


000270 


Set N Condition Code Bit 


SEV 


000262 


Set V Condition Code Bit 


SEZ 


000264 


Set Z Condition Code Bit 


SOB 


077000 


Subtract One And Branch 


SUB 


160000 


Subtract Source From 
Destination 


SWAB 


000300 


Swap Bytes 


SXT 


006700 


Sign Extend 


TRAP 


104400 


Trap 


TST 


005700 


Test Destination 


TSTB 


105700 


Test Destination (Byte) 


WAIT 


000001 


Wait For Interrupt 


XFC 


076700 


Extended Function Code 


XOR 


074000 


Exclusive OR 





COMMERCIAL INSTRUCTION SET (CIS) OP CODES 



Every operation listed in the CIS table has two instruction mnemonics. 
Thp suffix "T", atl-achpd t-ci pvf^ry spronrl mnfiTioni r- , indjcatf^s thnr thp 
addresses are inline. The inline instructions require two arguments; 
the other instructions (excepting L2DN and L3DN) reuuire no arguments. 



Instruction 
Mnemonic 



Octal 
VaJ ue 



Operation 



ADDN 

ADDNI 

ADDP 

ADDPI 

ASHN 

ASHNI 

ASEIP 

ASIIPJ... 

CMPC 

CMPCI 

CMPN 

CMPNI 

CMPP 

CMPPI 

CVTLN , 

CVTLNI 

CVTLP 

CVTLPI 

CVTNP 

CVTNPI 

CVTPN 

CVTPNI 

DIVP 

DIVPI 

LOCC 

LOCCI 



076050 
076150 
076070 
076170 
076056 
076156 
076076 

076044 
076144 
076052 
076152 
076072 
076J72 
076057 
076157 
076077 
076177 
076055 
076155 
076054 
076154 
076075 
076175 
076040 
076140 



Add Numeric 
Add Numeric 
Add Packed 
Add Packea 

Arithmetic Shift Numeric 
Arithmetic Shift Numeric 
Arithmetic Shift Packed 
. Ar-lthmctixL- Shi ft-Jack.eLd. 
Compare Character String 
Compare Character String 
Compare Numeric 
Compare Numeric 
Compare Packed 
Compare Packed 
Convert Long to Numeric. 
Convert Long to Numeric 
Convert Long to Packed 
Convert Long to Packed 
Convert Numeric to Packed 
Convert Numeric to Packed 
Convert Packed to Numeric 
Convert Packed to Numeric 
Divide Decimal 
Divide Decimal 
Locate Character 
Locate Character 
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Instruction 


Octal 




Mnemonic 


Value 


Operation 


i L2DN* 


07602N 


Load 2 Descriptors ia(RN) + 


i L3DN* 


07606N 


Load 3 Descriptors @{RN)i- 


MATC 


G76045 


Match Character 


MATCI 


076]45 


Match Character 


MOVC 


076030 


Hove Character 


MOVCI 


076130 


Move Character 


MOVRC 


075031 


Move Reverse Justified Cnaractcr 


MOVKCI 


076131 


Move Reverse Justified Character 


MOVTC 


076032 


Move Translated Character 


MOVTCI 


076132 


Move Translated Character 


MULP 


076074 


Multiply Decimal 


MULPI 


076174 


Multiply Decimal 


SCANC 


076042 


Scan Character 


SCANCI 


076142 


Scan Character 


SKPC 


076041 


Skip Character 


SKPCI 


076141 


Skip Character 


SPANC 


076043 


Span Character 


SPANCl 


076143 


Span Character 


SUBN 


076051 


Subtract Numeric 


SUBNI 


076151 


Subtract Numeric 


SUBP 


076071 


Subtract Packed 


SUBPI 


076171 


Subtract Packed 



FLOATING POINT PROCESSOR OP CODES 



Instruction 


Octal 




Mnemonic 


Value 


Operation 


ABSD 


170600 


Make Absolute Double 


ABSF 


170600 


Make Absolute Floating 


ADDD 


172000 


Add Double 


ADDF 


172000 


Add Floating 


CFCC 


170000 


Copy Floating Condition 
Codes 


CLRD 


170400 


Clear Double 


CLRF 


170400 


Clear Floating 


CMPD 


173400 


Compare Double 


CMPF 


173400 


Compare Floating 


DIVD 


174400 


Divide Double 


DIVF 


174400 


Divide Floating 


LDCDF 


177400 


Load And Convert From 
Double To Floating 


LDCFD 


177400 


Load And Convert From 
Floating To Double 


LDCID 


177000 


Load And Convert Integer To 
Double 


LDCIF 


177000 


Load And Convert Integer To 
Floating 


LDCLD 


177000 


Load And Convert Long 
integer To Double 



* where N=0, 
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Instruction 


Octal 




Mnemonic 


Value 


Operation 


LDCLF 


177000 


Load And Convert Long 
integer To Floating 


LDD 


172400 


Load Double 


LDEXP 


176400 


Load Exponent 


LDF 


172400 


Load Floating 


LDFPS 


170100 


Load FPPs Program Status 


MFPD 


106500 


Move From Previous Data 
Space 


MODD 


171400 


Mill ^ x'^'* '' '^nd "^nte'^^r i*"^ 
Double 


MODF 


171400 


Multiply And Integerize 
Floating 


MTPD 


106600 


Move To Previous Data Space 


MULD 


171000 


Multiply Double 


MULF 


171000 


Multiply Floating 


NEGD 


170700 


Negate Double 


NEGF 


170700 


Negate Floating 


SETD 


170011 


Set Double Mode 


SETF 


170001 


Set Floating Mode 


SETI 


170002 


Set Integer Mode 


SETL 


170012 


Set Long Integer Mode 


SPL 


000230 


Set Priority Level 


STAO 


170005 


Diagnostic Floating Point 


STBO 


170006 


Diagnostic Floating Point 


STCDF 


176000 


Store And Convert From 
Double To Floating 


STCDI 


175400 


Store And Convert From 
Double To Integer 


STCDL 


175400 


Store And Convert From 
Double To Long Integer 


STCFD 


176000 


Store And Convert From 
Floating To Double 


STCFI 


175400 


Store And Convert From 
Floating To Integer 


STCFL 


175400 


Store And Convert From 
Floating To Long Integer 


STD 


174000 


Store Double 


STEXP 


175000 


Store Exponent 


STF 


174000 


Store Floating 


STEPS 


170200 


Store FPPs Program Status 


STST 


170300 


Store FPPs Status 


SUBD 


173000 


Subtract Double 


SUBF 


173000 


Subtract Floating 


TSTD 


170500 


Test Double 


TSTF 


170500 


Test Floating 
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C.2 MACRO-11 DIRECTIVES 



The MACRO-11 directives that follow are described in greater detail in 
Appendix B. 



Directive 



Function 



•ASCII 
•ASCIZ 

.ASECT 

.BLKB 

.BLKW 

.BYTE 

.CSECT 

.DSABL 
. ENABL 
.END 
.ENDC 
.ENDM 

.ENDR 

.EOT 
. ERROR 

.EVEN 
.FLT2 

.FLT4 

.GLOBL 
. IDENT 

.IF 
.IFF 

. IFT 

. IFTF 

.IIF 

,IRP 

.IRPC 

.LIMIT 
.LIST 

.MCALL 



with 



for 



Translates character string to ASCII equivalents. 

Translates character string to ASCII equivalents; 

inserts zero byte as last character. 

Begins absolute program section (provided for 

compatibility with other PDP-11 assembliers) . 

Reserves byte block in accordance with value of 

specified argument. 

Reserves word block in accordance with value of 

specified argument. 

Generates successive byte data in accordance 

specified arguments. 

Begins relocatable program section (provided 

compatibility with other PDP-11 assemblers) . 

Disables specified function. 

Enables specified function. 

Defines logical end of source program. 

Defines end of conditional assembly block. 

Defines end of macro definition, repeat block, 

indefinite repeat block. 

Defines end of current repeat block (provided 

compatibility with other PDP-11 assemblers) . 

Define End of Tape condition (ignored). 

Outputs diagnostic message to listing file 

command output device. 

Word-aligns the current location counter. 

Causes two words of storage to be generated 

each floating-point argument. 

Causes four words of storage to be generated 

each floating-point argument. 

Declares global attribute for specified symbol (s). 

Labels object module with specified program 

version number. 

Begins conditional assembly block. 

Begins subconditional assembly block 

conditional assembly block test is false) . 

Begins subconditional assembly block 

conditional assembly block test is true) . 

Begins subconditional assembly block (whether 

conditional assembly block test is true or false) . 

Assembles immediate conditional assembly statement 

(if specified condition is satisfied). 

Begins indefinite repeat block; replaces 

specified symbol with specified successive real 

arguments. 

Begins indefinite repeat block; replaces 

specified symbol with value of successive 

characters in specified string. 

Reserves two words of storage for high and low 

addresses of task image. 

Controls listing level count and format of 

assembly listing. .MACRO Denotes start of macro 

definition. 

Identifies required macro definition (s) for 

assembly. 



or 



for 



or 



for 



for 



(if 
(if 
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Directive 



.MEXIT 

.NARG 

,NCHR 

.NLIST 

.NTYPE 

.ODD 

.PACKED . 
. PAGE 
.PRINT 
.PSECT 

.RADIX 
.RAD50 

• REPT 

. RESTORE 

.SAVE 

.SBTTL 



.WORD 



Function 



or 



indefinite 
number of 



of 



Exit from current macro definition 

repeat block. 

Equates specified symbol to the 

arguments in the macro expansion. 

Equates specified symbol to the number 

characters in the specified character string. 

Controls listing level count and suppresses 

specified portions of the assembly listing. 

Equates specified symbols to the addressing mode 

Byte-aligns the current location counter. 

■Gii^^^]Stti^rjfeeJdi^j.JfitV 2 dlgits-pe'E'byte- ' 

Advances form to top of next page. 

Prints specified message on command output device. 

Begins specified program section having specified 

attributes. 

Changes current program radix to specified radix. 

Generates data block having Radix-50 equivalents 

of specified character string. 

Begins repeat block and replicates it according to 

the value of the specified expression. 

Stores the current program section context on 

top of the program section context stack. 

Retrieves the program section from the top of 

program section context stack. 

Prints specified subtitle text as the second 

of the assembly listing page header. 

Prints specified title text as object module name 

in the first line of the assembly listing page 

header . 

Generates successive word data in accordance with 

specified arguments. 



the 
the 

line 
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APPENDIX D 
ERROR MESSAGES 



An error code is printed as the first character in a source line 
containing an error. This error code identifies the error condition 
detected during the processing of the line. Example: 



26 000236 010102 



MOV Rl,R2,A 



The extraneous argument A in the MOV instruction above causes the line 
to be flagged with a Q (syntax) error. 



Error Code 



Meaning 



Assembly error. Because many different conditions 
produce this error message, the directives which 
may yield a general assembly error have been 
categorizeu 
conditions: 



i-»exww 






lese 



CATEGORY 1: ILLEGAL ARGUMENT SPECIFIED. 



.RADIX — A value other than 
specified as a new radix. 



2, 8, 



or 



10 



IS 



.LIST/.NLIST — Other than a legally defined 
argument (see Table 6-2) is specified with the 
directive . 

.ENABL/.DSABL — Other than a legally defined 
argument (see Table 6-3) is specified with the 
directive, or the attribute arguments of a 
previously declared program section 

.PSECT — Other than a legally-defined argument 
(see Table 6-4) is specified with the 
directive, or the attribute arguments of a 
previously declared program section change (see 
Section 6.7.1.1) . 

.IF/. IIP — Other than a legally defined 
conditional test (see Table 6-6) or an illegal 
argument expression value is specified with the 
directive. 



.MACRO — An illegal or duplicate symbol 
in dummy argument list. 



found 
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ERROR MESSAGES 



Error Code 



Meaning 



A (cont.) 



.TITLE — Program name is not specified in the 
directive, or first non-blank character 
following the directive is a non-Radix-50 
character . 

.IRP/.IRPC — No dummy argument is specified in 
the directive. 

.NARG/ .NCHR/ .NTYPE — No symbol is specified 
in the directive. 



.IF/.IIF — No conditional 
specified in the directive. 



argument 



IS 



CATEGORY 3: UNMATCHED DELIMITER/ILLEGAL ARGUMENT 
CONSTRUCTION. 

. ASCII/. ASCIZ/.RAD50/.IDENT — Character string 
or argument string delimiters do not match, or 
an illegal character is used as a delimiter, or 
an illegal argument construction is used in the 
directive. 

.NCHAR — Character string delimiters do not 
match, or an illegal character is used as a 
delimiter in the directive. 



CATEGORY 4: GENERAL ADDRESSING ERRORS. 

This type of error results from one of 
possible conditions: 



several 



1. Permissible range of a branch instruction 
(from -128(10) to +127(10) words) has been 
exceeded. 

2. A statement makes invalid use of the 
current location counter. For example, a 
" .=expression" statement attempts to force 
the current location counter to cross 
program section (.PSECT) boundaries. 

3. A statement contains an invalid address 
expression: 

In cases where an absolute address 
expression is required, specifying a global 
symbol, a relocatable value, or a complex 
relocatable value (see Section 3.9) results 
in an invalid address expression. 

If an undefined symbol is made a default 
global reference by the .ENABL GBL 
directive (see Section 6.2) during passl, 
any attempt to redefine the symbol during 
pass 2 will result in an invalid address 
expression. 
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Error Code 



A (cont.) 



Meaning 



4. 



5. 



In cases where a relocatable address 
expression is required, either a 
relocatable or absolute value is 
permissible, but a global symbol or a 
complex relocatable value in the statement 
results in an invalid address expression. 

For example: 

•BLKB/ . BLKW/ . REPT — Other than an absolute 
value or an expression which reduces to an 
absolute value has been specified with the 
directive. 

Multiple expressions are not separated by a 
comma. This condition causes the next 
symbol to be evaluated as part of the 
current expression. 

.SAVR — The stack is full when the .SAVE 
diicutivc is isbuoo. 

.RFISTOKF. — The Stack is empty when the 
.RESTORE directive is issued. 



CATEGORY 5i 



ILLEGAL FORWARD REFERENCE. 



Thii 

possible conditions: 



ii i-< 



- rim a 1 



<-V>Q»- 



1. A global assignment statement 
(symbol==expression or symbol==: expres- 
sion*) contains a forward reference to 
another symbol. 

2. An expression defining the value of the 
current location counter contains a forward 



Bounding error. Instructions or word data are 
being assembled at an odd address. The location 
counter is incremented by 1. 

Doubly-defined symbol referenced. Reference was 
made to a symbol which is defined more than once. 



-1*^ rlTKZii^4-Ti7d nr^4- 



lA7)-icin 4-Vio onri — oF— filfs 



IS 



reached during source input and the .END directive 
has not yet been encountered, MACRO-11 generates 
this error code, ends assembly pass 1, and 
proceeds with assembly pass 2. Also caused by 
assembler-stack overflow. In this case MACRO-11 \ 
will place a question mark (?) into the line at \ 
the point where the overflow occurred. , 

Illegal character detected. Illegal characters ; 
which are also non-printable are replaced by a | 
question mark (?) on the listing. The character | 
is then ignored. j 



RT-11 V4.0 only. 
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ERROR MESSAGES 



Error Code 



Meaning 







Input line is greater than 132(10) characters in 
length. Currently, this error condition is caused 
only during macro expansion when longer real 
arguments, replacing the dummy arguments, cause a 
line to exceed 132(10) characters. 

Multiple definition of a label. A label was 
encountered which was equivalent (in the first six 
characters) to a label previously encountered. 

A number contains a digit that is not in the 
current program radix. The number is evaluated as 
a decimal value. 

Opcode error. Directive out of context. 
Permissible nesting level depth for conditional 
assemblies has been exceeded. Attempt to expand a 
macro which was unidentified after .MCALL search. 



Phase error. A label 
from one assembly 
definition of a local 
local symbol block, 
block defined by the 
attempt has occurred 
program section othe 
effect when the bloc 
P also appears if 
assembled. 



's definition of value varies 

pass to another or a multiple 

symbol has occurred within a 

Also, when in a local symbol 

.ENABL LSB directive, an 

to define a local symbol in a 

r than that which was in 

k was entered. An error code 

an .ERROR directive is 



Questionable syntax. Arguments are missing, too 
many arguments are specified, or the instruction 
scan was not completed. 



Register-type 
reference to 



error. An invalid use of or ' 
a register has been made, or an j 
attempt has been made to redefine a standard 
register symbol without first issuing the .DSABL 
REG directive. 

Truncation error, A number generated more than 16 
bits in a word, or an expression generated more 
than 8 significant bits during the use of the 
,BYTE directive or trap (EMT or TRAP) instruction. 

Undefined symbol. An undefined symbol was 
encountered during the evaluation of an 
expression; such an undefined symbol is assigned 
a value of zero. Other possible conditions which 
result in this error code include unsatisfied 
macro names in the list of , MCALL arguments and a 
direct assigment {symbol=expression or 
symbol=: expression) statement which contains a 
forward reference to a symbol whose definition 
also contains a forward reference; also, a local 
symbol may have been referenced that does not 
exist in the current local symbol block. 

Instruction error. The instruction so flagged is 
not compatible among all members of the PDP-11 
family. See Section 5,3 for details. 
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APPENDIX E 
SAMPLE CODING STANDARD 



Local user requirements must be met in a coding standard, but 
following this model as closely as possible helps you and DIGITAL by 
simplifying communication and software maintenance. Remember that 
this is a sample and may not entirely apply to your system. 



E.l LINE FORMAT 

Source lines are from one to eighty characters in length with the 
following format: 

1. Label Field - if present, begins in column 1 

2. Operation field - begins in column 9 (tab stop 1) 

3. Operand field - begins in column 17 (tab stop 2) 

4. Comment field - begins in column 33 (tab stop 4). If the 
operand field extends beyond column 33 (tab stop 4) leave a 
space and start the comment. 



E . 2 COMMENTS 

To make the program easier to understand, comments should be used to 
explain the logic behind the instructions. In general this will 
consist of a comment per line of code. However, if a particularly 
difficult or obscure section of code is used, precede that section 
with a longer explanation. 

Comments that are too long for the comment field may be continued on 
the following line. Begin the new line with a semicolon, space over 
to the column the comment began in and continue writing. 

If a lengthy text is needed for an explanation, begin the comment with 
a line containing only the characters ;+ and end it with a line 
containing only the characters ;-. The lines between these delimiters 
should each begin with a semicolon and a space. For example: 



; + 



THE INVERT ROUTINE ACCEPTS 

APPLIES THE KOLMOGOROV ALGORITHM 

TO ALPHABETIZE THEM. 
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SAMPLE CODING STANDARD 
E.3 NAMING STANDARDS 

E.3.1 Registers 

E.3. 1.1 General Purpose Registers - Use the default name: 

R0=0 ;REG 

Rl=l ;REG 1 

R2=2 ;REG 2 

R3=3 ;REG 3 

R4=4 ;REG 4 

R5=5 ;REG 5 

SP=6 ; STACK POINTER (REG 6) 

PC=7 ; PROGRAM COUNTER (REG 7) 

NOTE 

These register names will be defined 
within the assembler; other standard 
symbols must be put in a file and linked 
with the program. 



E. 3.1.2 Hardware Registers - Use the hardware definition. For 
example, PS (Program Status Register) and SWR (Switch Register). 



E. 3.1.3 Device Registers - Use the hardware notation. For example, 
the control status register for the RK disk is RKCS. 



E.3. 2 Processor Priority 

Testing or altering the processor priority is done using the symbols 

PRO, PRl, PR2, PR? 

which are eauated to their corresoondina orioritv bit oattern. 
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E.3.3 Symbols* 

The following chart diagrams the syntax of the 5 major types of symbol 
names: 



symbol 


pos-1 


pos-2 


pos-3 


pos-4 


pos-5 


pos-6 


length 


non-global 
symbol 


letter 


a-num/ 
null 


a-num/ 
null 


a-num/ 
null 


a-num/ 

null 


a-num/ 
null 


>=1 


f^lobal 
symbol 


*** 


a— T^nm 

nui'l ' 


a — rmm / 

null 


a— niiTn / 

null 


a-num'' 
null"" 


a_r) iim / 

null"" 


> = 1 


global 
offset 


letter 


$/. 
*** 


a-num 


a-num/ 
null 


a-num/ 
null 


a-num/ 
null 


> = 3 


global bit 
pattern 


letter 


a-num 


$/. 
*** 


a-num/ 


a-num/ 
null 


a-num/ 
null 


>=4 


local 
symbol 


number 
** 


$ 










>=2 



where: a-num is an alphanumeric character, 

E.3.3.1 Symbol Examples 
Non-Global Symbols 

AlB 

ZXCJl 

INSRT 

$JIM 
•VECTR 
$SEC 
Global Absolute Offset Symbols 
A$JIM 
A$XT 
A.ENT 



* Symbols that are branch targets are also called labels, but we will 
always use the term "symbol", 

** Number is in the range 0<number<65535 . 

*** The use of $ or . for global names is reserved for DEC-supplied 
software. 
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Global Bit Pattern Symbols 

Al$20 

B3.6 

JI.M 
Local Symbols 

37$ 

271$ 

6$ 



E.3.3.2 Local Symbols - Target symbols for branches that exist solely 
for positional reference will use local symbols of the form 

<num>$: 

Local symbols are formatted such that the numbers proceed sequentially 
down the page and from page to page. 



E.3,3.3 Global Symbols - Use of global symbols is restricted, within 
reason, to those cases where reference to the code occurs external to 
the code. 

A program never contains a .GLOBL statement without showing cause. 



E.3.3.4 Macro Names - In a macro name the last two characters {last 
character possibly being null) have special significance; the next to 
last character is a $, the last character specifies the mode of the 
macro. 

For example, in the three macro forms in-line, stack, and p-section, 
the in-line form has no suffix, the stack has an <S> suffix, and the 
p-section a <C>. Thus the Queue I/O macro can be written as any of 

QIO$ 

QIO$S 

QIO$C 

depending on the form required. These are not reserved letters. 



E.3.3.5 General Symbols - Make frequently used bit patterns such as 
carriage return (CR) and line feed (LF) conventional symbols as they 
are needed. 
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E.4 PROGRAM MODULES 

There are no limits on program size. However, since the virtual 
memory capacity of a computer is finite keep programs as compact as 
possible by: 

1. creating them for a single function 

2. writing them in accordance with the memory allocation 
guidelines in Appendix F. 

Code areas are different than data areas. Code is read-only but data 
can be resd~onl^^ or read—write* read—onl^^ /^a4-a oK/miI/^ Kq c^^nrarfrs^-^^ 
from read-write data. Both areas, code and data, should have 
explanatory comments. 



E.4.1 The Module Preface 

Put each program module in a separate file. For easy reference the 
file name should be similar to the name of the module. The file type 
is of the form 'NNN' where 'NNN' is the edit or the version number 
(see Section E-8). The availability of File Control Services and File 
Control Primitives will greatly simplify version number maintenance. 



E,4.2 The Module 

Below is a list of the information included in e^ch mod'^l^ ^^ ^^ 
formatted as follows: 

1. The first eight items appear on the same page and do not have 
explicit headings. Item 3 may be omitted if the blank 
p-section is being used. 

2. Headings start at the left margin*; descriptive text is 
indented 1 tab position. 

preceded and followed by lines containing only a leading <;>. 
Items which do not apply may be omitted. 

4. A .TITLE statement that specifies the name of the module. If 
a module contains more than one routine, subtitles may be 

used. 

5. An .IDENT Statement specifying the version number (see 
Section E-8) . 

6. A .PSECT statement that defines the program section in which 
the module resides. 



* The left margin consists a semicolon, a space and then the heading, 
therefore, the text of the heading begins in column 3. 



E-5 



SAMPLE CODING STANDARD 

7. A copyright statement, and the disclaimer, 

COPYRIGHT (C) 1979 BY 

DIGITAL EQUIPMENT CORPORATION, MAYNARD , MASS. 

THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE 
USED AND COPIED ONLY IN ACCORDANCE WITH THE TERMS OF 
SUCH LICENSE AND WITH THE INCLUSION OF THE ABOVE 
COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER COPIES 
THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE 
AVAILABLE TO ANY OTHER PERSON. NO TITLE TO AND 
OWNERSHIP OF THE SOFTWARE IS HEREBY TRANSFERRED. 

THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE 
WITHOUT NOTICE AND SHOULD NOT BE CONSTRUED AS A 
COMMITMENT BY DIGITAL EQUIPMENT CORPORATION. 

DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR 
RELIABLILITY OF ITS SOFTWARE ON EQUIPMENT WHICH IS 
NOT SUPPLIED BY DIGITAL. 

8. The version number of the file (see Section E-8) . 

9. The name of the principal author and the date on which the 
module was first created. 

10. The name of each modifying author and the date of 
modification. These names and dates appear one per line and 
in chronological order. 

11. A brief statement of the function of the module. 



NOTE 

Items 3 to 11 should appear on the same 
page. 

12. A list of the definitions of all equated local symbols used 
in the module. These definitions appear one per line and in 
alphabetical order. 

13. All local macro definitions, preferably in alphabetical order 
by name. 

14. All local data. The data should indicate 

a. Description of each element (type, size, etc.) 

b. Organization (functional, alpha, adjacent, etc.) 

c. Adjacency requirements 

15. A more detailed definition of the function of the module. 

16. A list of the inputs expected by the module. This includes 
the calling sequence if non-standard, condition code 
settings, and global data settings. 
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17. A list of the outputs produced as a result of entering this 
module. These include delivered results and condition code 
settings but not side effects. These outputs are visible to 
the caller. 

18. A list of all effects produced as a result of entering this 
module. Effects include side effects, alterations in the 
state of the system not explicitly expected in the calling 
sequence and effects not visible to the caller. 

19. The module code. 



E.4.3 Module Example 

FILE-EXAMPL.SOl 

.TITLE EXAMPLE 
.IDENT /Ol/ 
.PSECT KERNEL 

COPYRIGHT (C) 1979 BY 

DIGITAL EQUIPMENT COPORATION, MAYNARD , MASS. 

THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED 
ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE 
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE, OR ANY OTHER 
COPIES THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY 
OTHER PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY 
TRANSFERRED. 

THE INFORMATION IN THIS DOCUMENT IS SUBJECT TO CHANGE WITHOUT NOTICE 
AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT 
CORPORATION . 

DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS 
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL. 

JOE PASCUSNIK l-JAN-72 
MODIFIED BY: 

RICHARD DOE 21-JAN-73 
SPENCER THOMAS 12-JUN-78 
Brief statement of the module's function 
EQUATED SYMBOLS 

List equated symbols 

LOCAL MACROS 
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Local Macros 
LOCAL DATA 

Local data 

+ 
Module function-details 

INPUTS: 

Description of inputs 
OUTPUTS: 

Description of outputs 
EFFECTS: 

Description of effects 

Begin Module Code 



E.4.4 Modularity 

No other characteristic has more impact on the ultimate engineering 
success of a system than does modularity. Adherence to a set of call 
and return conventions helps achieve this modularity. 



E. 4.4.1 Calling Conventions (Inter-Module/Intra-Module) 

Transfer of Control 

Macros exist for call and return. The actual transfer is via a 
JSR PC instruction. For register save routines, a JSR Rn,SAVE is 
permitted. 

The CALL macro is: 

CALL subr-name 
The RETURN macro is: 

RETURN 

Register Conventions 

On entry, a subroutine minimally saves all registers it intends 
to alter except result registers. On exit it restores these 
registers. (The preservation of the register state is assumed 
across calls.) 

Argument Passing 

Any registers may be used, but their use should follow a coherent 
pattern. For example, if passing three arguments, use RO , Rl and 
R2 rather than RO , R2 , R5 . Saving and restoring occurs in one 
place. 
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E.4.4.2 Exiting - All subroutine exits occur through a single RETURN 
macro. 



E.4.4.3 Success/Failure Indication - The C bit is used to return the 

success/failure indicator, where success equals 0, and failure equals 

1. The argument registers can be used to return values or additional 
success/failure data. 



verifying the validity of arguments passed to them. The design of a 
module's calling sequence should aim at minimizing the validity checks 
by minimizing invalid combinations. Programmers may add test code to 
perform additional checks during checkout. All code should aim at 
discovering an error as close (in terms of instruction executions) to 
its occurrence as possible. 



E.5 CODE FORMAT 



E.5.1 Program Flow 

Programs are organized on the listing so that they flow down the page, 
even at the cost of an extra branch or jump. 

For example: 










;. TEST y> 








BBB 


>• 


AAA 




















COMMON 



















appears on the listing as; 



TST 

BNE BBB 



AAA: 



BR 



CMN 
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BBB: 



CMN: 



rather than 



TST 

BNE BBB 



AAA: 



CMN: 



BBB! 



BR 



CMN 



E.5.2 Common Exits 

A common exit appears as the last code sequence on the listing, 
the flow chart: 



Thus 



1 




2 




3 




4 


































FYIT 



































appears on the listing as; 

£r 1\^ ■ •••• •••• 



BR 



EXIT 



PR2: 



BR 



EXIT 
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PR3! 



PR4; 



BR 



EXIT 



EXIT: 

and not as 

PRl: 



EXIT: 



PR2; 



PR3; 



PR4! 



BR 



BR 



EXIT 



EXIT 



BR 



EXIT 



E.5.3 Code with Interrupts Inhibited 

Code that is executed with inter ruT^ts inhibited, is flagged by a three 
semicolon ( ; ; ; ) comment delimiter. For example: 



.ERTZ; 



10$; 



; ENABLE BY RETURNING 
;BY SYSTEM SUBROUTINES, 



BIS 


#PR7,PS ;; 


INHIBIT INTERRUPTS 


BIT 


#PR7,+2(SP) ;; 


C 


BEQ 


10$ ;; 





RTT 




M 
M 
E 

N 


• • • • 

• • • ■ 


.... ;; 


• • • ■ 


• • • • t t 


T 
S 



E-11 



SAMPLE CODING STANDARD 



E.5.4 Code in System State 

RSX-llM Executive subroutines and other privileged code that is 
executed in system state is flagged by a two semicolon (;;) comment 
delimiter. For example: 

SWITCH TO SYSTEM STATE , ... 

AND EXIT. 



CALL 



$SWSTK,EXIT 



INHIBIT CONTEXT SWITCHING 
RETURN IN SYSTEM STATE 



RETURN 



EXIT! 



;; GO BACK TO USER STATE (EXIT) 
; USER STATE CODE 



E.6 INSTRUCTION USAGE 



E.6.1 Forbidden Instructions 



The use of instructions or index words 
previous instruction. For example: 



as literals of the 



MOV 



§PC, Register 



BIC Src,Dst 

uses the bit clear instruction as a literal. This may seem 
to be a very "neat" way to save a word but what about 
maintaining a program using this trick? To compound the 
problem, it will not execute properly if I/D space is enabled 
on the 11/45. In this case @PC is a D bank reference. 

The use of the MOV instruction instead of a JMP instruction 
to transfer program control to another location. For 
example: 

MOV #ALPHA,PC 

transfers control to location ALPHA. Besides taking longer 
to execute (2.3 microseconds for MOV vs. 1.2 for JMP) the 
use of MOV instead of JMP makes it nearly impossible to pick 
up someone else's program and tell where transfers of control 
take place. What if one would like to get a jump trace of 
the execution of a program (a move trace is unheard of)? As 
a more general issue, other operations such as ADD and SUB 
from PC should be discouraged. 

The seemingly "neat" use of all single word instructions 
where one double-word instruction could be used and would 
execute faster and would not consume additional memory. 
Consider the following instruction sequence: 



CMP 



-(Rl) ,(-Rl) 



CMP 



-(Rl) ,-(Rl) 
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The intent of this instruction sequence is to subtract 8 from 
register Rl (not to set condition codes) . This can be 
accomplished in approximately 1/3 the time via a SUB 
instruction (9.4 vs. 3.8 microseconds) at no additional cost 
in memory space. 

4. Self-relative address arithmetic (.+n) is absolutely 
forbidden in branch instructions; its use in other contexts 
must be avoided if at all possible and practical. 



When using the PDP-11 conditional branch instructions, it is 
imperative that the correct choice be made between the signed and the 
unsigned branches. 



SIGNED 


UNSIGNED 


BGE 


BHIS (BCC) 


BLT 


BLO 


BGT 


BHI 


BLE 


BLOS (BCS) 



A common pitfall is to use a signed branch (for example, BGT) when 
comparing two memory addresses. This works until the two addresses 
have opposite signs; that is, one of them goes across the 16K 
(100000(8)) bound. This type of coding error usually results from 
re-linking the program at different addresses and/or changing the size 
of the program.. 



E.7 PROGRAM SOURCE FILES 

Source creation and maintenance is done in base levels. A base level 
is the point at which the program source files have been frozen. From 
the freeze point to the next base level, corrections are not made 
directly to the base level itself, rather a file of corrections is 

source file is desired, the correction file is applied to the base 
file. 

The accumulation of corrections proceeds until a logical breaking 
point has occurred (a milestone or significant implementation point 
has been reached) . At this time all accumulated corrections are 
applied to the previous base level to create a new base level and 
correction files are started for the new base level. 



E.8 PDP-11 VERSION NUMBER STANDARD 

The PDP-11 Version Number Standard applies to all modules, parameter 
files, complete programs, and libraries which are written as part of 
the PDP-11 Software Development effort. It is used to provide unique 
identification of all released, pre-released , and in-house software. 

The version number is limited in that only six characters of 
identification are used. Future implementations of the Macro 
Assembler, linker, and librarian should provide for at least nine 
characters, and possibly twelve. It is expected that this standard 
will be improved as the need arises. 



E-13 



SAMPLE CODING STANDARD 



Version Identifier Format: 

<version> <edit> <patch> 

where: <version> consists of two decimal digits which 

represent the release number of a program. 
The version number starts at 00 and is 
incremented to reflect the number of major 
changes in the program. 

<edit> consists of two decimal digits which 

represent the number of alterations made to 
the source program. The edit number begins 
at 01 (is null if there are no edits) and is 
incremented with each alteration. 

<patch> is a letter between B and z which represents 

the number of alterations made to the binary 
form of the program. The patch number begins 
at B (is null if there are no patches) and 
changes alphabetically with each patch. 

These fields are interrelated. when <version> is changed, then 
<patch> and <edit> must be reset to nulls. It is intended that when 
<edit> is incremented, then <patch> will be re-set to null, because 
the various bugs have been fixed. 



E.8.1 Displaying the Version Identifier 

The visible output of the version identifier should appear as: 

Program 

Name <key-letter> <version> - <edit> <patch>, 

where the following Key Letters have been identified: 

X in-house experimental version 

Y field test, pre-release, or in-house release version 

V released or frozen version 

'X' corresponds roughly to individual support, 'Y' to group support, 
and 'V to company support. 

The dash which separates <version> from <edit> is not used if both 
<edit> and <patch> are null. When a version identifier is displayed 
as part of program identification, then the format is: 

Program 

Name <space><key-letter><version> - <edit><patch> 

Examples: 

PIP X03 

LINK VB04-C 
MACRO Y05-01 
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E.8.2 Use Of the Version Number in the Program 

All sources must contain the version number in an .IDENT directive. 
In programs (or libraries) which consist of more than one module, each 
module must have a version number. The version number of the program 
or library is not necessarily related to the version numbers of the 
constituent modules; it is perfectly reasonable, for example, that 
the first version of a new FORTRAN library, VOO, contain an existing 
SIN routine, say V05-01. 

Parameter files are also required to contain the version number in an 
.IDENT directive. Because the assembler records the last .IDENT seen, 
narameter files must precede the program. 

Entities which consist of a collection of modules or programs (for 

example, the FORTRAN Library) have an identification module in the 

first position. An identification module exists solely to provide 
identification. For example: 

;OTS IDENTIFICATION 
.TITLE FTNLIB 
.IDENT /003010/ 
.END 

is an identification module. 
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APPENDIX F 
ALLOCATING VIRTUAL MEMORY 



This appendix is intended for the MACRO-11 user who wants to avoid the 
problem of thrashing, by optimizing the allocation of virtual memory. 
Users of smaller systems, particularly those with the 8K subset 
version of MACRO-11, should become thoroughly familiar with the 
conventions discussed herein. This appendix discusses the following 
topics: 

1. General hints and space-saving guidelines 

2. Macro definitions and expansions 

3. Operational techniques. 

The user is assumed to have pursued a policy of modular programming, 
as advised in Appendix E. Modular programming results in bodies of 
code that are small, distinct and highly functional. Using such code, 
which presents many advantages, one can usually avoid the problem of 
insufficient dynamic memory during assembly. 



F.l GENERAL HINTS AND SPACE-SAVING GUIDELINES 

Work-file memory is shared by a number of MACRO-11 's tables, each of 
which is allocated space on demand (64K words of dynamically pageable 
storage are available to the assembler) . The tables and their 
corresponding entry sizes are as follows: 

1. User-defined symbols - four words.* 

2. Local symbols - three words.* 

3. Program sections - six words. 

4. Macro names - four words.* 

5. Macro text - nine words. 

6. Source files - six words. 

In addition, several scratch pad tables are used during the assembly 
process, as follows: 

1. Expression analysis - five words, 

2. Object code generation - five words. 

3. Macro argument processing - three words, 

4. .MCALL argument processing - five words. 



* Five words on RSX-llM. 
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The above information can serve as a guide for estimating dynamic 
storage requirements and for determining ways to reduce such 
requirements. 

For example, the use of local symbols whenever possible is highly 
encouraged, since their internal representation requires 25 percent 
less dynamic storage than that required for regular user-defined 
symbols. The usage of local symbols can often be maximized by 
extending the scope of local symbol blocks through the .ENABL 
LSB/.DSABL LSB MACRO-11 directives (see Sections 3.5 and 6.2), 

Since MACRO-11 does not support a purge function, once a symbol is 
defined, it permanently occupies its dynamic memory allocation. 
Numerous instances occur during conditional assemblies and repeat 
loops when a temporarily assigned symbol is used as a count or offset 
indicator. If possible, the symbols so used should be re-used. 

In keeping with the same principle, special treatment should be given 
to the definition of commonly used symbols. Instead of simply 
appending a prefix file which defines all possibly used symbols for 
each assembly, users are encouraged to group symbols into logical 
classes. Each class can then become a shortened prefix file or a 
macro in a library (see Section F.2 below) . In either case, selective 
definition of symbolic assignments is achieved, resulting in fewer 
defined (but unreferenced) symbols. 

An example of this idea is seen in the definition of lAS/RSX-llM 
standard symbols. The system macro library, for example, supplies 
several macros used to define distinct classes of symbols. These 
groupings and associated macro names are as follows: 

DRERR$ - Directive return status codes 

FILIO$ - File-related I/O function codes 

IOERR$ - I/O return status codes 

SPCIO$ - Special I/O function codes 



F.2 MACRO DEFINITIONS AND EXPANSIONS 

Dynamic storage is used most heavily for the storage of macro text. 
Upon macro definition or the issuance of an .MCALL directive, the 
entire macro body is stored, including all comments appearing in the 
macro definition. For this reason, comments should not be included as 
part of the macro text. A librarian function switch (/SZ) are 
available to compress macro source text by removing all trailing 
blanks and tabs, blank lines, and comments. The system macro library 
(RSXMAC.SML) has already been compressed. User-supplied macro 
libraries (.MLB) and macro definition prefix files should also be 
compressed. For additional information regarding these two utility 
tasks, consult the applicable RSX-llM or RSX-llM-PLUS Utilities Manual 
(see Section 0.3 in the Preface). 

It often seems practical to include a file of commonly used macro 
definitions in each assembly. This practice, however, may produce the 
undesirable allocation of valuable dynamic storage for unnecessary 
macros. This waste of memory can be avoided by making the file of 
macto definitions a user-supplied macro library file (see Table 8-1) . 
This means that the names of desired macros must be listed as 
arguments in the .MCALL directive (see Section 7.8). 
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Certain types of macros can be redefined to null after they have been 
invoked. This practice not only frees storage space, it also 
eliminates the overhead and the dynamic memory wasted by calling a 
useless macro. The practice of redefining macros to null applies 
mainly to those that leave define symbolic assignments, as shown in 
the example below. The redefinition process may be accomplished as 
follows: 



.MACRO DEFIN 
SYMl = VALl 
SYM2 = VAL2 



; DEFINE SYMBOLIC ASSIGNMENTS, 



OFFl = SYMBOL 
0FF2 = OFFl+SIZl 
0FF3 = OFF2+SIZ2 



; DEFINE SYMBOLIC OFFSETS. 



OFFN = OFFM+SIZM 



.MACRO DEFIN 
.ENDM 

.ENDM DEFIN 



J MACRO NULL REDEFINITION. 



Macros exhibiting this redefinition property should be defined (or 
read via the .MCALL directive) and invoked before all other macro 
definition and/or .MCALL processing, a practice that ensures more 
efficient use of dynamic memory. 

The following RSX-llM system macros have the automatic null 
redefinition property after once being invoked: 

BDOFF$ - File Control Services (FCS) buffer descriptor offsets 

CSI$ - Command String Interpreter codes and offsets 

DRERR$ - Directive return status codes 

FCSBT$ - FCS bit value codes 

FDOFF$ - FCS file descriptor block offsets 

FILIO? - File-related I/O function codes 

FSROF$ - FCS file storage region (FSR) offsets 

GCMLD$ - Get Command Line codes and offsets 

IOERR$ - I/O return status codes 

NBOFF$ - FCS filename block offsets 

SPCIO$ - Special I/O function codes 



F-3 



ALLOCATING VIRTUAL MEMORY 

F.3 OPERATIONAL TECHNIQUES 

When, despite adhering to the guidelines discussed above, performance 
still falls below expectations, several additional measures may be 
taken to increase dynamic memory. 

The first measure involves shifting the burden of symbol definition 
from MACRO-11 to the linker or task builder. In most cases, the 
definition of system I/O and File Control Services (PCS) symbols (and 
user-defined symbols of the same nature) is not necessary during the 
assembly process, since such symbols are defaulted to global 
references (Appendix D.l, category 4 of error code A). The linker or 
task builder attempts to resolve all global references from 
user-specified default libraries and/or the system object library 
(SYSLIB) . Furthermore, by applying the selective search option for 
object modules consisting only of global symbol definitions, the 
actual additional burden to the linker is minimal. 

The second way is to produce only one output file (either object or 

listing) , as opposed to two. The additional memory required to 

support the second output file are allocated from available dynamic 
memory at the start of each assembly. 
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APPENDIX G 
WRITING POSITION INDEPENDENT CODE 

G.l INTRODUCTION TO POSITION INDEPENDENT CODE 

The output of a MACRO-11 assembly is a relocatable object module. The 
Task Builder or Linker binds one or more modules together to create an 
executable task image. Once created, if the program is to run it must 
be loaded at the virtual address specified at link time. This is 
because the Task Builder or Linker has to modify some instructions to 
reflect the memory locations in which the program is to run. Such a 
body of code is considered position-dependent (dependent on the 
virtual addresses to which it is bound) . 

All PDP-11 processors offer addressing modes that make it possible to 
write code that does not depend on the virtual addresses to which it 
is bound. Such code is termed position-independent and to run can be 
loaded at any virtual address. Position-independent code can im-prove 
system efficiency, both in use of virtual address space and in 
conservation of physical memory. 

In multiprogramming systems like IAS, RSX-llM and RSX-llM-PLUS, it is 
important that many tasks be able to share a single physical copy of 
common code, for example a library routine. To make the optimum use 
of a task's virtual address space, shared code should be 
position-independent. Position-dependent code can also be shared, but 
it must appear in the same virtual locations in every task using it. 
This restricts the placement of such code b" the Task Builder or 
Linker and can result in the loss of virtual addressing space. 

The construction of position-independent code is closely linked to the 
proper usage of PDP-11 addressing modes. The remainder of this 
Appendix assumes you are familiar with the addressing modes described 

in Chapter 5. 

All addressing modes involving only register references are 
position-independent. These modes are as follows: 

R register mode 

(R) register deferred mode 

(R)+ autoincrement mode 

@(R)+ autoincrement deferred mode 

-(R) autodecrement mode 

@-(R) autodecrement deferred mode 

When using these addressing modes, you are guaranteed 
position-independence, provided the contents of the registers have 
been supplied such that they are not dependent upon a particular 
virtual memory location. 
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The relative addressing modes are position-independent when a 
relocatable address is referenced from a relocatable instruction. 
These modes are as follows: 

A relative mode 
@A relative deferred mode 

Relative modes are not position-independent when an absolute address 
(that is a non-relocatable address) is referenced from a relocatable 
instruction. In this case, absolute addressing (@#A) may be used to 
make the reference position-independent. 

Index modes can be either position- independent or position-dependent, 
according to their use in the program. These modes are as follows: 

X(R) index mode 
@X(R) index deferred mode 

If the base, X, is an absolute value (for example, a control block 
offset) , the reference is position- independent. For example: 

MOV 2(SP),R0 ; POSITION-INDEPENDENT 
N=4 

MOV N(SP),RO ; POSITION-INDEPENDENT 

If, however, X is a relocatable address, the reference is 
position-dependent. For example: 

CLR ADDR(Rl) ; POSITION-DEPENDENT 

Immediate mode can be either position- independent or not, according to 
its usage. Immediate mode references are formatted as follows: 

#N immediate mode 

When an absolute expression defines the value of N, the code is 
position-independent. When a relocatable expression defines N, the 
code is position-dependent. That is, immediate mode references are 
position-independent only when N is an absolute value. 

Absolute mode addressing is position- independent only in those cases 
where an absolute virtual location is being referenced. Absolute mode 
addressing references are formatted as follows: 

@#A absolute mode 

An example of a position-independent absolute reference is a reference 
to the directive status word ($DSW) from a relocatable instruction. 
For example: 

MOV (a#$DSW,RO ; RETRIEVE DIRECTIVE STATUS 



G . 2 EXAMPLES 

The RSX-llM library routine, PWRUP, is a FORTRAN callable subroutine 
that establishes or removes a user power failure Asynchronous System 
Trap (AST) entry point address. Imbedded within the routine is the 
AST entry point that saves all registers, effects a call to the 
user-specified entry point, restores all registers on return, and 
executes an AST exit directive. The following examples are excerpts 
from this routine. The first example. Figure G-1 has been modified to 
illustrate position-dependent references. The second example, Figure 
G-2 , is the position-independent version. 
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s + 

> Position dependent code exasrle 

i " 

PURUPJJ CLR -(SP) J Assume success 

i Perfora further initialization!.. 





MOV 


♦0TSVfR4 




MOV 


<SP)+.R2 




BNE 


10* 




CLR 


-tSP) 




BR 


20* 


lOiJ 


HOV 


R2.F.PF(R4) 




MOV 


»BA»-<SP) 


20$! 






r Cont 


inue processing... 



rPoint R4 at object tine sustes save ares 

> the above reference to fOTSV is position- 

i dependent 

iRetrieve AST entru point address 

iBranch if one uas specified 

?Xf none? specify no pcysr fail routine 

>Bupass AST setup 

iSet the AST entry point 

rPush our AST service address 

i the above reference to BA is position- 

r dependent 



f AST service routine 



BA; MOV RO.-(SP) JPreserve RO 
i Rest of routine follows.. . 



Figure G-1 Example of Position-Dependent Code 



r Position independent code example 



PWRUPS; CLR -(3P) iAssuae success 

i Perfora necessary initialization... 





MOV 


(?*$0TSVfR4 




MOV 


<SP)+.R2 




BNE 


10$ 




CLR 


-(SP) 




BR 


20$ 


10$! 


MOV 


R2.F.PF<R4) 




MOV 


PCt-(SP) 




ADD 


*BA-.f (SP) 


20$! 






i Con 


tinue processing. ■ . 



fpoint R4 at object tine systeii save area 

J the above reference to $OTSV is position- 

i independent 

^Retrieve AST entry point address 

fBrsnch if one uas specified 

fif none» specify no power fail routine 

iBypass AST setup 

SSet the AST entry point 

JPush our PC to relocate our AST service addr 

iRelacate our AST service address now 

r the above reference to BA is position- 

i independent) this costs one word to relocate 



> AST service routine 



BA! MOV RO.-(SP) fPreserve RO 
i Rest of routine follows... 



Figure G-2 Example of Position-Independent Code 
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The position-dependent version of the subroutine contains a relative 
reference to an absolute symbol ($OTSV) and a literal reference to a 
relocatable symbol (BA) . Both references are bound by the Task 
Builder to fixed memory locations. Therefore, the routine will not 
execute properly as part of a resident library if its location in 
virtual memory is not the same as the location specified at link time. 

In the position-independent version, the reference to $OTSV has been 
changed to an absolute reference. In addition, the necessary code has 
been added to compute the virtual location of BA based upon the value 
of the program counter. In this case, the value is obtained by adding 
the value of the program counter to the fixed displacement between the 
current location and the specified symbol. Thus, execution of the 
modified routine is not affected by its location in the image's 
virtual address space. 

The MACRO-11 Assembler provides a way of checking whether the code is 
position-independent. In an assembly listing, MACRO-11 inserts a ' 
character following the contents of any word which requires the Task 
Builder or Linker to perform a relocation operation and, therefore, 
may not be position independent code. The cases which cause an 
apostrophe to be inserted in the assembly listing are as follows: 

1. Absolute mode references when the reference is relocatable. 
References are not flagged when they are absolute. For 
example: 

MOV @#ADDR,R1 ;PIC ONLY IF ADDR IS ABSOLUTE. 

2. Index and index deferred mode references when the offset is 
relocatable. For example: 

MOV ADDR(R1),R5 ;NON-PIC IF ADDR IS RELOCATABLE. 
MOV @ADDR(Rl),R5 ;NON-PIC IF ADDR IS RELOCATABLE. 

3. Relative and relative deferred mode references when the 
address specified is relocatable with respect to another 
program section. For example: 

MOV ADDRl,Rl ;NON-PIC WHEN ADDRl IS ABSOLUTE 
MOV § ADDRl, Rl 

4. Immediate mode references to relocatable addresses. 

MOV #ADDR,R1 ;NON-PIC WHEN ADDR IS RELOCATABLE. 

In one case, MACRO-11 does not flag a potential position-dependent 
reference. This occurs where a relative reference is made to an 
absolute virtual location from a relocatable instruction (see the MOV 
$0TSV,R4 instruction in Figure G-1) . 

References requiring more than simple relocation at link time are 
indicated in the assembly listing. Simple global references are 
flagged with the letter G. Statements which contain multiple global 
references or require complex relocation, are flagged with the letter 
C (see Section 3.9 and Chapter 4). It is difficult to positively 
state whether or not a C-flagged statement is position-independent. 
However, in general, position dependence can be decided by applying 
the guidelines discussed earlier in this Appendix to the resulting 
address value produced at link time. 
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APPENDIX H 
SAMPLE ASSEMBLY AND CROSS REFERENCE LISTING 



R50UNP MACRO Y04,00 29-AUG-79 1A!06;39 
TABLE OF CONTENTS 

2- 1 RAII50 unpack routine 



R50UNP MACRO Y04,00 29-AUG-79 16!06!39 PAGE 1 



3 

4 

5 

6 

7 

B 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 



.TITLE R50UNP 
. IDENT /02/ 



COPYRIGHT (c) 1979 BY 
DIGITAL EQUIPMENT CORPORATION, MAYNARDf MASS. 

THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED 
ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE 
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER 
COPIES THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY 
OTHER PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY 
TRANSFERRED. 

THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE 
AND SHOULD NOT BE CONSTRUED A3 A COMMITMENT BY DIGITAL EQUIPMENT 
CORPORATION, 



DIGITAL ASSUMES NO RESPONSIBILITY FDR THE USE OR RELIABILITY 
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL. 



OF ITS 



jKUATh HlbiUHY; 

D.N. CUTLEfi 



lO-FEB-73 
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SAMPLE ASSEMBLY AND CROSS REFERENCE LISTING 



RSOUNP MACRO Y04,00 29-AUG-79 16!06:39 PAGE 2 
RAD50 UNPACK ROUTINE 



.SBTTL RAD50 unpack routine 



S 

9 
10 
11 
12 
13 

14 000000 
15 

16 000000 010446 R50UNPi!M0U 

17 000002 012704 MOM 

OOOOOOG 
IB 000006 012401 1»! MOV 

19 000010 012703 MOV 

003100 

20 000014 004767 CALL 

000030 

21 000020 012703 MOV 

000050 

22 000024 004767 CALL 

000020 

23 000030 010100 MOV 

24 000032 004767 CALL 

000016 

25 000036 020427 CMP 

000004G 

26 000042 001361 

27 000044 012604 

28 000046 000207 
29 
30 
31 

32 000050 005000 10«: CLR 

33 000052 071003 DIV 
34 



R50UNP 

Unpack a 6 char RADSO suabol to ASCII 

Enter uith R2 -> Output ASCII strina 
SYMBOL f SYMBOL+2 = RAD50 SBmbol to unpack 



Return with R2 -> Past output strina 
ROt Rlr R3 Destroaed 



.PSECT PUREI.I 



R4,-(SP) 
♦SYMBOL. R4 

(R4)+jRl 
*50*50rR3 

10* 

*50fR3 

10* 

Rl.RO 
11* 

R4.*SYMB0L+4 



■Save R4 

(Point at RADSO sa»bol buffer 

(Get next RADSO word 

ISet divisor for hiah character 

(Unpack and store the character 

(Now set divisor for »iddle character 

(Unpack and store the character 

(Copy reasinina character 
(Translate and store it 

(Test if last word done 



BNE 


1* 


(Branch if no 


MOV 


(SP)+,R4 


(Restore R4 


RETURN 




(Return to caller 



( Divide RADSO word and convert char to ASCII 



RO 
R3,R0 



35 
36 
37 
38 
39 
40 
41 



Translate RADSO character code to ASCII 
= space 
1-32 = A-Z 

33 = ♦ 

34 = 

35 = unused code 
36-47 = 0-9 



43 000054 005700 11»: TST RO 

44 000056 001412 BEQ 23* 

45 000060 020027 CMP R0.»33 

000033 

46 000064 002405 BLT 22* 

47 000066 001402 BEQ 21* 

43 000070 062700 ADD »22-ll>R0 
000011 

R50UNP MACRO Y04.00 29-AUG-79 16:06:39 PAGE 2-1 
RADSO UNPACK ROUTINE 



49 


000074 


062700 
177711 


2i»: 


ADD 


»11-100>R0 


50 


000100 


062700 
000040 


22»: 


ADD 


#100-40. RO 


51 


000104 


062700 
000040 


2ii'. 


ADD 


♦40, RO 


52 


000110 


110022 




MOVE 


R0.(R2)+ 


53 
54 

55 


000112 


000207 




RETURN 






000001 




.END 





(Test if spsce 
(Branch if so 
(Test if Kiddle 

(Branch if alphabetic 
(Branch if dollar sian 
.Dot or disits 0-9 



(Dollar 

(Alphabetic 

(Space 

(Store ASCII char in buffer 
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SAMPLE ASSEMBLY AND CROSS REFERENCE LISTING 



RSOUNP MACRO r04.00 29-ftUG-79 16:06:39 PAGE 2-2 
SYMBOL TABLE 

R50UNP DOOOOORG 002 SYHBOL» *tt*tt GX 

. ABS4 000000 000 

000000 001 

PUREI 000114 002 

ERRORS detected: 

VIRTUAL HEHORV USED: 7936 WORDS ( 1 PAGES) 
DYNAHIC MEMORY AVAILABLE FOR 72 PAGES 

f R50UNp=R50UNP/c : c : s ; M ; E : R : p/e ; gbl : lc/l : ttm 



R50UNP MACRO Y04.00 29-AUG-79 16:06:39 PAGE S-1 
CROSS REFERENCE TABLE (CREF WOl-08 ) 



R50UNP 2-16# 

SYMBOL 2-17 2-25 



R50UNP MACRO Y04.00 29-AUG-79 16:06:39 PAGE R-1 
CROSS REFERENCE TABLE (CREF VOl-08 ) 

RO 2-23* 2-32* 2-33* 2-43 2-45 2-48* 2-49* 

Rl 

R2 

R3 

R4 2-16 2-17* 2-18 2-25 2-27* 

SP 



2-23* 


2-32* 


2-33* 


2-30* 


2-51* 


2-52 


2-18* 


2-23 




2-52* 






2-19* 


2-21* 


2-33 


2-16 


2-17* 


2-18 


2-16* 


2-27 





R50UNP MACRO Y04.00 29-AU6-79 16:06:39 PAGE C-1 
CROSS REFERENCE TABLE (CREF UOl-08 ) 





0-0 


. ABS. 


0-0 


PUREI 


2-14 



H-3 



INDEX 



6-21 to 
6-21, 6-24 
6-26, 



A error, 3-10, 3-13, 5-9, 6-15, 

6-23, 6-24, 6-26, 6-27, 6-30, 

6-31, 6-36, 6-38, 6-40, 6-42, 

6-45, 6-46; 6-55, 7-2, 7-12 

to 7-14, 7-16, 7-17, 7-19 
Absolute address, D-2 
Absolute binary output, 6-19 
Absolute expression, 3-17 
Absolute mode, 5-1, 5-6, 5-6, 

B-2, G-2, G-4 
Absolute module, 6-40 
Absolute program section, 6-40 to 

6-43, B-4 
See also .ASECT directive. 
ADD instruction, E-12, G-3, H-2 
Addition operator, 3-2, 3-5, B-1 
Address boundaries, 6-36 
Addressing modes, 5-1 
Apostrophe, G-4 
ASCII 

character set, A-1 
conversion characters, 

6-24 
.ASCII directive, 6-1 , 

to 6-27, 6-34 
.ASCIZ directive, 6-1 , 

6-27, 6-34, B-4 
.ASECT directive, 3-11, 3-13, 

3-14, 6-2, 6-43 to 6-45, B-4 
Assembler , 
directives 

See Permanent symbol table, 
version number, 6-4 
Assembly, 

error, See A error. 

listing symbols, 4-1 

pass 1, 1-1 , 1-2, 6-12, 6-15, 

6-16, 6-20, 6-48, 8-7, 8-10, 

9-5, D-3 
pass 2, 1-2, 6-12, 6-16, 6-20, 

7-15, 8-7, 8-10, 9-5, D-3 
Assignment operator, 

See Direct assignment operator. 
Assignment statement. 

See Direct assignment statement, 
Autodecrement deferred mode, 5-1, 

5-4, B-2, G-1 
Autodecrement indicator, 3-2 
Autodecrement mode, 5-1, 5-4, 

B-1, B-2, G-i 
Autoincrement deferred mode, 5-1, 

5-4, B-2, G-1 
Autoincrement indicator, 3-2 
Autoincrement mode, 5-1, 5-3, 

B-1, B-2, G-1 



E-13 
E-13 
H-2 
E-13 
E-13 
E-13 
E-13 



E-13 



Base level , E-13 
BCC instruction, 
ECS instruction , 

BGE instruction, 

BGT instruction, 

BHl instruction, 

BHIS instruction, 

BIG instruction, E-12 

Binary operator, 3-4, 3-5, 3-16 

Blank line, 2-1 

BLE instruction, 

.BLKB directive, S-T*, 6-2, 6-34 

to 6-36, B-4, D-3 
.BLKW directive, 3-14, 6-2, 6-35, 

6-36, 6-47, B-4, D-3 
BLO instruction, E-13 
BLOS instruction, E-13 
BLT instruction, E-13, H-2 
BNE instruction, E-9, E-10, G-3, 

H-2 
BR instruction, E-9, E-10, E-11, 

G-3 
Branch instruction, 
addressing, 5-8, D-2 
use of, E-13 
.BYTE directive, 6-2, 6-21, 6-22, 

6-34, B-4, D-4 



C bit, E-9 

CALL instruction, H-2 

we. J. J. A.iig, ^.v^ii « (,.i v.^vy.i , ^ — KJ 

Character set, 

ASCII, A-1 to A-3 

legal, 3-1 to 3-3 

Radix-50, A-4, A-5 
CLR instruction, G-2, G-3, H-2 
CMP instruction, E-12, H-2 
Coding standard, E-1 
Comment , E-1 , E-5 

delimiter, 3-2, B-1, E-11, E-12 

field, 2-1, 2-4, 2-5, E-1 
Commercial instruction set, C-3 
Common exit, E-10 
Complex relocatable expression, 

3-18 
Complex relocation, 4-1, G-4 
Concatenation indicator, 3-3, 

B-1, B-3 
Conditional assembly, 6-49 to 
6-55, 7-7, 7-15, D-4 

immediate, 6-54, 6-55 



Index-1 



INDEX (Cont.) 



Conditional assembly block, 7-3, 
B-M, B-5 

Conditional assembly directive, 
6-49 

Copyright statement, E-6 

Cross-reference listing, 3-12, 

6-19, 8-Y, 8-9, 8-11, 8-13 to 
8-17, 9-2, 9-3, 9-5 to 9-7 

.CSECT directive, 3-11, 3-13, 
6-2, 6-43 to 6-45, 9-6, B-4 

Current location counter, 2-2, 

3-2, 3-12 to 3-15, 3-17, 5-7, 
6-11, 6-34 to 6-36, 6-41 to 
6-43, B-5, B-7, D-2, D-3 



D error, 2-3 
Data , 

sharing, 6-43 
storage, 6-2 

storage directives, 6-21 
Default radix, 3-14 
Default register definitions, 

3-10, 6-20 
Deferred addressing indicator, 

3-2, B-1 
Delimiting characters, 3-3, 6-17, 

6-26, B-3 to B-5, B-7 
Device register, E-2 
Direct assignment, 

operator, 3-1, 3-2, 3-9, B-1 
statement, 3-6 to 3-9, 3-13, 
6-34 
Direct command language, 8-8 
Directives , 

See Permanent symbol table. 
DIV instruction, H-2 
Division operator, 3-2, 3-5, B-1 
Double ASCII character indicator, 

3-2, B-1 
.DSABL directive, 6-2, 6-18 to 
6-21, 8-6, 8-9, 9-4, B-4, 
D-1, D-4 
Dummy argument, 7-2, 7-11, 7-16 



.ENDM directive, 6-13, 6-21, 7-2, 
7-3, 7-6 to 7-8, 7-10, 7-11, 
7-17 to 7-19, B-4, B-7, F-3 
.ENDR directive, 7-18, 7-19, B-4, 

B-7 
Entry point symbol, 6-48 
.EOT directive, 6-2, 6-37, B-5 
.ERROR directive, 7-15, B-5, D-4 
Error messages, D-1 to D-4 
.EVEN directive, 6-2, 6-27, 6-35, 

B-5 
Expression , 

evaluation of, 3-16 
Expression indicator, 
immediate, 3-2, B-1 
External expression, 5-17 
External symbol, 6-49, 
See also Global symbol. 



Field terminator, 3-2, B-1 

FILES-n, 6-19 

Floating-point directives, B-5, 

See also .FLT2 directive. 
Floating-point indicator, B-3 
Floating-point processor, 3-14, 

6-31, 6-32, C-4 
Floating-point rounding, 6-19, 

6-32 
Floating-point truncation, 6-19, 

6-32 
.FLT2 directive, 6-2, 6-33, B-5 
.FLT4 directive, 6-2, 6-33, B-5 
FLX, 6-19 

Forbidden instructions, E-12 
Format control, 2-5 
Formatted binary, 6-19 
FORTRAN, 6-43, 6-44, E-15, G-2 
Forward reference, 3-8, 3-9, 

3-10, 3-13, D-4 
illegal, D-3 
Function control switches. 

See Switches, function control. 
Function directive, 6-18 



E error, 6-37 

EMT instruction, 5-9, D-4 

.ENABL directive, 6-2, 6-18 to 

6-21, 8-6, 0-9, 9-4, B-4, 

D-1, D-2, D-4, F-2 
.END directive, 6-2, 6-37, B-4, 

D-3, H-2 
.ENDC directive, 6-2, 6-12, 6-49 

to 6-51, 6-53 to 6-55, 7-3, 

B-4 



Global expression evaluation, 

3-17 
Global label , 6-48 
Global reference, 6-20, 6-48, 

F-4, G-4 
Global symbol, 1-2, 3-7, B-5, 

D-2, D-3, E-4 
Global symbol definition ,. 2-2 , 

3-1, 3-2, 3-8, 6-48, 
See also .GLOBL directive. 
Global symbol directory, 1-2 
.GLOBL directive, 3-7, 6-2, 6-48, 

B-5, E-4 
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Hardware register, E-2 



IAS, 6-2, 6-3Y, 6-i|4, 7-19, 8-11, 

8-13, 8-14, 8-16 to 8-20, G-1 
.IDENT directive, 6-2, 6-17, B-5, 

D-2, E-5, E-7, E-15, H-1 
.IF directive, 6-2, 6-12, 6-49 to 

6-55, 7-3, 7-8, B-5^ D-1, D-2 
.IFF directive, 6-2, 6-52 to 

6-54, B-5 
.IFT directive, 6-2, 6-52 to 

6-54, B-5 
.IFTF directive, 6-2, 6-52, 6-53, 

B-5 
.IIF directive, 6-2, 6-54, 6-55, 

B-6, D-1, D-2 
Illegal characters, 3-3, D-2, D-3 
Illegal forward reference, D-3 
Immediate conditional assembly, 

6-54, 6-55 
Immediate expression indicator, 

3-2, B-1 
Immediate mode, 5-1, 5-5, 5-6, 

B-2, G-2, G-4 
Implicit .WORD directive, 2-1, 

2-4, 6-23 
Indefinite repeat block, 

See Repeat block, indefinite. 
Index deferred mode, 5-1, 5-5, 

B-2, G-2, G-4 
Index mode, 5-1, 5-5, 5-7, B-2, 

G-2, G-4 
inital expression indicator, 3-2 
Initial argument indicator, 3-2, 

B-1 
Initial register indicator, 3-2, 

B-1 
Instruction set, 
commercial, C-3 
PDP-11, C-1 
Interrupts, E-11 
.IRP directive, 7-2, 7-16 to 

7-18, B-6, D-2 
.IRPC directive, 7-2, 7-16 to 

7-18, B-6, D-2 
Item terminator, 3-2, B-1 



L error, 2-1 

Label , 

field, 2-1 to 2-3, E-1 
multiple definition, 2-3 
terminator, 3-1 > B-1 

.LIMIT directive, 6-3, 6-36, B-6 

Line format, E-1 

Linf* nrinfpi" 1i<:rTnp fri i«m or ^ a,^ 

6-6, 6-12, 
See also Listing control. 
Linker, 1-2, 2-2, 6-17, 6-40, 

6-43, 6-44, 6-48, F-4, G-1, 

G-4 
Linking, 4-1, 6-36 
.LIST directive, 6-3, 6-9, 6-10, 

6-12 to 6-14, 6-21, 8-6, 8-9, 

8-11, 9-4, B-6, D-1 
Listing control, 6-4 to 6-13, 
See also .LIST directive, 
•NLIST directive. 
Listing control switches. 

See Switches, listing control. 
Listing level count, 6-9, 6-10, 

6-12, B-6, B-7 
Local symbol, 3-11, 3-12, 7-8, 

7-9, D-4, E-4, F-2 
Local symbol block, 3-11, 3-12, 

6-19, D-4 , F-2 
Location counter. 

See Current location counter. 
Location counter control, 6-34, 

6-35 
Logical AND operator, 3-2, 3-5, 

6-51, B-1 
Logical inclusive OR operator, 

3-2, 3-5, 6-51 
Logical OR operator, B-1 
Lower-case ASCII, 6-19 



JMP instruction, 5-3, E-12 
JSR instruction, 5-3, E-8 



M error, 2-3, 3-1, 3-2, 3-8 
Macro , 

argument, 7-6, 7-13, 7-14, B-3 
argument concatenation, 7-11 
attribute directive, 7-11 
definition, 6-30, 7-1 to 7-12, 

7-14, 7-16, 7-17, 7-19, B-4 , 

B-6, B-7, E-6, F-2 
directive, 7-1, 7-2, 7-4, 

See also .MACRO directive, 
expansion, 7-1, 7-3i 7-5 to 

7-7, 7-9, 7-11, 7-16, B-6, 

D-4, F-2 
expansion listing, 6-9, 6-12 
keyword argument, 7-4, 7-9, 

7-10 
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Macro, (Cont.) 

keyword indicate 
name, 7-1, 7-2, 
nesting, 7-2, 7- 
nutneric argument 
redefinition, F- 
symbol, 3-6 
Macro call , 7-1 , 7 
7-12, 7-19, B- 
See also .MCALL 
Macro call argumen 
Macro call numeric 
.MACRO directive, 
to 7-8, 7-10, 
D-1, F-3 
Macro library dire 
See .MCALL direc 
Macro symbol table 
MACRO-11 character 
See character se 
.MCALL directive, 
8-6, 8-10, 8-1 
B-6, V-H, F-1 
Memory , 

allocation, 6-39 

F-2 
conservation, F- 
.MEXIT directive, 

7-19, B-6 
Modularity, 6-41, 
Module checking ro 
Module preface, E 
Monitor console ro 
MOV instruction, 3 
6-3t, 6-54, D- 
G-4, H-2 
MOVE instruction. 
Multiple definitio 
Multiple expressio 
Multiple label, 2 
Multiple symbol, 2 
Multiplication ope 
3-5, B-1 



r, 3-1 

7-4, D-4, E-4 
3, 7-5, 7-16 
, 7-7 

3 

-4 to 7-10, 

1, B-6, 
d i r : c t i V e . 
t, 7-4 

argument, 3-3 
6-13, 6-21, 7-1 
7-11, 9-6, B-6, 

ctive , 
tive . 

, 3-6, 3-7 
set , 
t , legal . 
7-19, 7-20, 

2, 9-4 to 9-6, 
to F-3 

, 6-44, F-1, 

1 

7-3, 7-17 to 

E-8, F-1 

utine, E-9 

5 

utine, 8-1, 8-2 

-13, 3-14, 

1 , E-12, G-2 to 

H-2 

n, See M error. 

n, 2-4 

2 

-4 

rator, 3-2, 



7-11, 7-12, 

7-1 1 , 7-n, B-6, 



N error, 3-14 
Naming standard, E-2 
.NARG directive, 7-8 

B-6, D-2 
, NCHR directive 

D-2 
Nested conditional directive, 

6-51, 6-54, 7-3 
.NLIST directive, 6-3, 6-9 to 

6-14, 6-16, 6-21, 8-6, 8-9, 

9-4, B-7, D-1 



.NTYPE directive, 7-11, 7-14, 

B-7, D-2 
Number of arguments. 

See .NARG directive. 
Numeric argument indicator, B-1 
Numeric control, 

operator, 6-31 

temporary, 6-33, 6-34, B-3 
Numeric directive, 6-31 



error, 6-37, 6-51, 6-52, 7-3, 

7-12, 7-14, 7-20 
Object module name, 1-2 
.ODD directive, 6-3, 6-34, 6-35, 

B-7 
Operand field, 2-1, 2-4, E-1 
Operand field separator, 3-2, B-1 
Operation field, E-1 
Operator field, 2-1, 2-3, 2-4 
Overlay, 6-39, 6-41 



P error , 
.PACKED d 
6-34, 
.PAGE dir 

B-7 
Page, 
header , 
number , 
PAL-1 1R a 
Patch, E- 
Permanent 

C-7, 
Position 

G-4 

.PRINT di 

Processor 

Program c 

Program c 

Program d 

8-13, 

Program m 

Program s 

See .PS 

Program s 

Program s 

Program v 

see Ver 

Programmi 

.PSECT di 

3-14, 

6-45, 

D-2, 



6-20, 7-15 
irective, 6-3, 6-29, 

C-7, B-7 
ective, 6-3, 6-18, 7-4, 



6-4 

6-18 
ssembler, 6-55 
14 

symbol table, C-1 to 
3-6, 3-7 
independent code, G-1 to 

rective, 7-15, B-7 

priority, E-2 
ounter, 5-1, E-2, G-4 
ounter definition, 3-10 
evelopment system, 8-11, 

8-14 
odule, E-5 
ection directive, 
ECT directive, 
ection name, 6-38 
ection table, 1-1 
ersion number, 
sion identifier, program, 
ng standard, E-1 
rective , 3-11, 3-1 3> 

6-2, 6-3, 6-19, 6-38 to 

7-9, 9-6, B-7, D-1, 
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Q error, 6-26, 6-27, 6-31, 6-35 



R error, 3-10 
.RAD50 direoti 
6-26, B-7, 
Rad ix control . 
B-7 
temporary, 6 
.RADIX direct! 
6-30, 6-31 
Radix-50, 3-5, 
B-3, B-5, 
character se 
temporary op 
Read-only acce 
Read/write ace 
Register , 

conventions , 
definitions , 

6-20 
expression , 
symbol, 3-10 
term indicat 
Register defer 

B-2, G-1 
Register 
Relative 
B-2, 
Relative 
B-2, 
Relocat 



ve, 6-3, 6-27, 
H-2 
3_1i). 6-29; 6 

29, 6-30, B-3 
ve, 3-14, 6-3, 
, B-7, D-1 

6-28, 6-29, 6 
B-8 

t, A-4 

erator, 6-28 
ss, 6-38 
ess, 6-38 

E-8 

default, 3-10, 

5-2, B-1 

D-4 
or, 3-2, B-1 
red mode , 5- 1 , 



-^1 . 



-38, 



mode , 
defer 
G-2, 
mode , 
G-2, 
5ble ex 
Relocatable mo 
Relocatable pr 
to 6-43, B 
Relocation, 4- 
Relocation bia 

4-1, 6-40 
Repeat block, 
directive, S 
indefinite 
B-4, B-6 
.REPT directiv 
7-19, B-7, 
Reserved syrabo 
.RESTORE direc 
6-3, 6-19, 
D-3 
.RETURN direct 
RSTS, 6-2, 6-3 
RSX run-time s 
RSX-llM, 6-2, 
6-38, 6-44 
8-16 to 8- 
RSX-1 1M-PLUS, 
8-16, G-1 
RT-11, 6-2, 6- 
6-37, 6-38 
7-19, 9-2 
RT-11 run-time 



5-2, 

G-1 



5-1 i 5-2, B-2, 
red mode , 5-1 , 5-8 , 
G-4 

5-1, 5-7, 5-8, 
G-4 

pression, 3-17 
dule, 6-40 
ograra section, 6-41 
-4 

1, 6-40 
s, 2-2, 3-17, 3-18, 



ee .REPT directive. 
7-3, 7-16 to 7-19, 

e, 7-2, 7-16, 7-18, 

D-3 
Is, 2-3, 3-1, 3-7 
tive, 3-n, 3-13, 

6-46, B-7, C-7, 

ive, H-2 
7, 9-1 to 9-8 
ystem, 9-1, 9-2 
6-12, 6-17, 6-37, 
, 7-19, 8-1 to 8-7, 
20, E-12, F-3, G-1 
6-2, 8-8 to 8-10, 



.SAVE directive, 6-3, 6-19, 6-45, 

6-47, B-7, B-8, C-7, D-3 
.SBTTL directive, 6-3, 6-4, 6-15, 

6-16, B-8, H-2 
Separating characters, 3-3 
Sequence number, 6-19 
Single ASCII character indicator, 

3_3_ B-ij B-3 
Source line format, 2-5 
Source line terminator, B-1 
Special characters, 3-1 to 3-3, 

7-6 
Stack pointer, E-2 
Stack pointer definition, 3-10 
Statement format, 2-1 
SUB instruction, E-12 
Subcond itional assembly, 6-52 to 

6-54 
Subtraction operator, 3-2, 3-5, 

B-1 
Success/ failure indicator, E-9 
Switches , 

function control, 8-5, 9-4 
listing control, 8-6 to 8-9, 

8-12, 9-4 
Symbol name syntax, E-3 
Symbol table, 1-1 , 1-2, F-1 
Symbolic argument, 6-41 
SYSLIB, F-4 
System macro library, 1-1, 7-19, 

8-6, 8-10, 8-12, 9-3, 9-5, 
See also .MCALL directive. 



12, 6-17, 6-20, 
, 6-40, 6-41, 6-45, 
to 9-8 
system, 9-1 



T error, 3-15, 6-22 

Table of contents, 6-12, 6-16, 

B-8 
Task builder. See Linker. 
Teleprinter listing format, 6-7, 
6-8, 6-12, 
See also listing control . 
Temporary numeric control. 

See numeric control, temporary. 
Temporary radix control, 

See radix control, temporary. 
Temporary Radix-50 operator, 6-28 
Term , 

definition of, 3-15, 3-16 
Terminal argument indicator, 3-2, 

B-1 
Terminal expression indicator, 

3-2 
Terminal register indicator, 3-2, 

B-1 
Terminating directive. 

See .END directive. 
Thrashing, F-1 
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.TITLE directive, 6-5, 6-4, 6-13, 
6-15, 6-21, B-8, D-2, E-5, 
E-7, E-15, H-1 
TRAP instruction, 5-9, D-1 
TST instruction, E-9 , E-10, H-2 



Version identifier, 
assembler, 6-4 
file, 8-17 
program, 6-17, B-5 
standard, E-13 to E-15 
See also .IDENT directive, 



U error, 3-8, 3-9, 3-15, 6-20, 

7-20, 8-6 
Unary operator, 3-M, 3-16, 7-5, 
7-7 
control, 6-29, 6-31 
universal, 3-3, 3-5, B-1 
Unconditional assembly, 6-52 
Undefined symbol, 3-8, 6-20, D-2, 
U-4, 
See also U error . 
Universal unary operator. 

See unary operator, universal. 
User-defined symbol, 3-6 to 3-8 
User-defined symbol table, 2-2, 
3-6 to 3-8, 3-15 



.WCRD directive, 3-13, 3-14, 6-3, 
6-22, 6-23, 6-31, 6-33, B-8, 
See also Implicit .WORD 
directive. 



L error , 5-3 
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READER'S COMMENTS 



NOTE: This form is for document comments only. DIGITAL will 
use comments submitted on this form at the company ' s 
discretion. If you require a written reply and are 
eligible to receive one under Software Performance 
Report (SPR) service, submit your comments on an SPR 
form. 

Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 



c 



CO 
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-2 Did you find errors in this manual? If so, specify the error and the 
page number. 



3 
U 



o 



Please indicate the type of reader that you most nearly represent. 

I I Assembly language programmer 

I I Higher- level language programmer 

I I Occasional programmer (experienced) 

I I User with little programming experience 

I 1 Student programmer 
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